1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/samples/aserverinfo/src/org/apidesign/aserverinfo/factories/ServerConnector.java	Sat Nov 15 06:53:43 2008 +0100
     1.3 @@ -0,0 +1,84 @@
     1.4 +package org.apidesign.aserverinfo.factories;
     1.5 +
     1.6 +import org.apidesign.aserverinfo.spi.ShutdownHandler;
     1.7 +import java.net.URL;
     1.8 +import org.apidesign.aserverinfo.spi.NameProvider;
     1.9 +import org.apidesign.aserverinfo.spi.ResetHandler;
    1.10 +import org.apidesign.aserverinfo.spi.URLProvider;
    1.11 +
    1.12 +/** A class to connect to server, identify it and manipulate with
    1.13 + * it state. The <a href="http://apidesign.org">Practical API Design</a>
    1.14 + * book used to call it AServerInfo.
    1.15 + * <p>
    1.16 + */
    1.17 +public final class ServerConnector {
    1.18 +    public String getName() {
    1.19 +        return name == null ? "noname" : name.getName();
    1.20 +    }
    1.21 +
    1.22 +    public URL getURL() {
    1.23 +        return url == null ? null : url.getURL();
    1.24 +    }
    1.25 +
    1.26 +    public void reset() {
    1.27 +        if (reset != null) {
    1.28 +            reset.reset();
    1.29 +        }
    1.30 +    }
    1.31 +
    1.32 +    /** Additional method for API clients not available from first version.
    1.33 +     * @since 2.0
    1.34 +     */
    1.35 +    public void shutdown() {
    1.36 +        if (shutdown != null) {
    1.37 +            shutdown.shutdown();
    1.38 +        }
    1.39 +    }
    1.40 +
    1.41 +    //
    1.42 +    // factories
    1.43 +    //
    1.44 +    
    1.45 +    // BEGIN: aserverinfo.regularcreate
    1.46 +    public static ServerConnector create(
    1.47 +        NameProvider nameProvider, 
    1.48 +        URLProvider urlProvider, 
    1.49 +        ResetHandler reset
    1.50 +    )
    1.51 +    // END: aserverinfo.regularcreate
    1.52 +    {
    1.53 +        return new ServerConnector(nameProvider, urlProvider, reset, null);
    1.54 +    }
    1.55 +    
    1.56 +    /** @since 2.0 */
    1.57 +    public static ServerConnector create(
    1.58 +        NameProvider nameProvider, 
    1.59 +        URLProvider urlProvider, 
    1.60 +        ResetHandler reset, 
    1.61 +        ShutdownHandler shutdown
    1.62 +    )
    1.63 +    // END: aserverinfo.regularcreate.withshutdown
    1.64 +    {
    1.65 +        return new ServerConnector(nameProvider, urlProvider, reset, shutdown);
    1.66 +    }
    1.67 +
    1.68 +    //
    1.69 +    // private part
    1.70 +    //
    1.71 +
    1.72 +    private final NameProvider name;
    1.73 +    private final URLProvider url;
    1.74 +    private final ResetHandler reset;
    1.75 +    private final ShutdownHandler shutdown;
    1.76 +
    1.77 +    private ServerConnector(
    1.78 +        NameProvider name, URLProvider url,
    1.79 +        ResetHandler reset, ShutdownHandler shutdown
    1.80 +    ) {
    1.81 +        this.name = name;
    1.82 +        this.url = url;
    1.83 +        this.reset = reset;
    1.84 +        this.shutdown = shutdown;
    1.85 +    }
    1.86 +
    1.87 +}