Шаблон Builder с наследованием

Я хочу представить URL-адрес URL-адреса веб-службы в качестве объекта и обнаружил, что существует множество общих параметров, которые могут быть "пузырящимися" в иерархии наследования. В запросе может быть множество параметров, некоторые обязательные и другие необязательные, для которых я считаю, что шаблон Bloch Builder является хорошим вариантом, эмулируя именованные аргументы с плавным интерфейсом.

В частности, я разрабатываю API-интерфейс веб-сервиса Google Maps, который имеет общий запрос веб-службы

http://maps.googleapis.com/maps/api/service/output?{parameters}

service и output являются обязательными аргументами, а sensor обязательным параметром. Существует также необязательный параметр language.

Каждая служба имеет свой набор обязательных и необязательных параметров. Служба Geocode имеет два необязательных параметра: bounds и region. Он также имеет взаимоисключающие обязательные параметры address или location, которые определяют тип службы (прямое или обратное геокодирование, соответственно). Я представляю это взаимное исключение с новыми классами детей.

Я представляю иерархию классов как таковую:

  .-----.
  | Url |
  '-----'
     ^
     |
.---------.
| Request |
'---------'
     ^
     |----------------------------+--------------...
.---------.                 .------------.
| Geocode |                 | Directions |
'---------'                 '------------'
     ^                            ^
     |------------+               .
 .--------.  .---------.          .
 | Direct |  | Reverse |          .
 '--------'  '---------'

Затем я хотел бы сделать что-то вроде следующего:

String output = "xml";
boolean sensor = true;
String address = "Av. Paulista, São Paulo, Brasil";
Bounds bounds  = new Bounds(-20, -10, -25, -20); //Geographic rectangle
String region  = "br";
String lang    = "pt-BR";
Coord location = new Coord(-12,-22);

DirectGeocodeRequestUrl direct = 
    new DirectGeocodeRequestUrl.Builder(output, sensor, address)
                               .bounds(bounds)
                               .language(lang)
                               .build();

ReverseGeocodeRequestUrl reverse = 
    new ReverseGeocodeRequestUrl.Builder(output, sensor, location)
                                .language(lang)
                                .region(region)
                                .build();

Как я могу создать Builder, который использует аргументы и методы из класса и суперклассов, в которые он вставлен?

ОТВЕТЫ

Ответ 1

Я строю свой ответ fooobar.com/info/172201/..., но рассматриваю эту многоуровневую иерархию.

Нам нужно реплицировать одну и ту же иерархию с внутренними классами Builder. Поскольку нам нужна цепочка методов, нам нужен метод getThis(), который возвращает листовой объект иерархии. Чтобы передать свой тип вверх иерархии, родительские классы имеют общий T, а лист связывает T с самим собой.

Он обеспечивает безопасность типов и избегает любого выброса исключений из-за неинициализированных обязательных параметров или опечаток, а также приятного свободного интерфейса. Тем не менее, это очень дорогостоящий и сложный дизайн для представления такой простой структуры, как URL. Надеюсь, что это кому-то полезно - я предпочел конкатенацию строк в конце.

RequestUrl:

public abstract class RequestUrl{
    public static abstract class Builder<T extends Builder<T>>{
        protected String output;
        protected boolean sensor;
        //Optional parameters can have default values
        protected String lang = "en"; 

        public Builder(String output, boolean sensor){
            this.output = output;
            this.sensor = sensor;
        }

        public T lang(String lang){
            this.lang = lang;
            return getThis();
        }

        public abstract T getThis();
    }

    final private String output;
    final private boolean sensor;
    final private String lang;

    protected RequestUrl(Builder builder){
        this.output = builder.output;
        this.sensor = builder.sensor;
        this.lang = builder.lang;
    }

    // other logic...
}

GeocodeRequestUrl:

public abstract class GeocodeRequestUrl extends RequestUrl {
    public static abstract class Builder<T extends Builder<T>>
        extends RequestUrl.Builder<Builder<T>>{

        protected Bounds bounds;
        protected String region = "us";

        public Builder(String output, boolean sensor){
            super( output, sensor );
        }

        public T bounds(Bounds bounds){
            this.bounds = bounds;
            return getThis();
        }

        public T region(String region){
            this.region = region;
            return getThis();
        }

        @Override
        public abstract T getThis();
    }

    final private Bounds bounds;
    final private String region;

    protected GeocodeRequestUrl(Builder builder){
        super (builder);
        this.bounds = builder.bounds;
        this.region = builder.region;
    }

    // other logic...
}

DirectGeocodeRequestUrl:

public class DirectGeocodeRequestUrl extends GeocodeRequestUrl {
    public static class Builder<Builder>
        extends GeocodeRequestUrl.Builder<Builder>{

        protected String address;

        public Builder(String output, boolean sensor, String address){
            super( output, sensor );
            this.address = address;
        }

        @Override
        public Builder getThis(){
            return this;
        }

        public DirectGeocodeRequestUrl build(){
            return new DirectGeocodeRequestUrl(this);
        }
    }

    final private String address;

    protected DirectGeocodeRequestUrl(Builder builder){
        super (builder);
        this.address = builder.address;
    }

    // other logic...
}

ReverseGeocodeRequestUrl:

public class ReverseGeocodeRequestUrl extends GeocodeRequestUrl {
    public static class Builder<Builder>
        extends GeocodeRequestUrl.Builder<Builder>{

        protected Coord location;

        public Builder(String output, boolean sensor, Coord location){
            super( output, sensor );
            this.location = location;
        }

        @Override
        public Builder getThis(){
            return this;
        }

        public ReverseGeocodeRequestUrl build(){
            return new ReverseGeocodeRequestUrl(this);
        }
    }

    final private Coord location;

    protected ReverseGeocodeRequestUrl(Builder builder){
        super (builder);
        this.location = builder.location;
    }

    // other logic...
}