jtulach@292: package org.apidesign.aserverinfo.factories;
jtulach@292: 
jtulach@292: import org.apidesign.aserverinfo.spi.ShutdownHandler;
jtulach@292: import java.net.URL;
jtulach@292: import org.apidesign.aserverinfo.spi.NameProvider;
jtulach@292: import org.apidesign.aserverinfo.spi.ResetHandler;
jtulach@292: import org.apidesign.aserverinfo.spi.URLProvider;
jtulach@292: 
jtulach@292: /** A class to connect to server, identify it and manipulate with
jtulach@292:  * it state. The <a href="http://apidesign.org">Practical API Design</a>
jtulach@292:  * book used to call it AServerInfo.
jtulach@292:  * <p>
jtulach@292:  */
jtulach@292: public final class ServerConnector {
jtulach@292:     public String getName() {
jtulach@292:         return name == null ? "noname" : name.getName();
jtulach@292:     }
jtulach@292: 
jtulach@292:     public URL getURL() {
jtulach@292:         return url == null ? null : url.getURL();
jtulach@292:     }
jtulach@292: 
jtulach@292:     public void reset() {
jtulach@292:         if (reset != null) {
jtulach@292:             reset.reset();
jtulach@292:         }
jtulach@292:     }
jtulach@292: 
jtulach@292:     /** Additional method for API clients not available from first version.
jtulach@292:      * @since 2.0
jtulach@292:      */
jtulach@292:     public void shutdown() {
jtulach@292:         if (shutdown != null) {
jtulach@292:             shutdown.shutdown();
jtulach@292:         }
jtulach@292:     }
jtulach@292: 
jtulach@292:     //
jtulach@292:     // factories
jtulach@292:     //
jtulach@292:     
jtulach@292:     // BEGIN: aserverinfo.regularcreate
jtulach@292:     public static ServerConnector create(
jtulach@292:         NameProvider nameProvider, 
jtulach@292:         URLProvider urlProvider, 
jtulach@292:         ResetHandler reset
jtulach@292:     )
jtulach@292:     // END: aserverinfo.regularcreate
jtulach@292:     {
jtulach@292:         return new ServerConnector(nameProvider, urlProvider, reset, null);
jtulach@292:     }
jtulach@292:     
jtulach@293:     // BEGIN: aserverinfo.regularcreate.withshutdown
jtulach@292:     /** @since 2.0 */
jtulach@292:     public static ServerConnector create(
jtulach@292:         NameProvider nameProvider, 
jtulach@292:         URLProvider urlProvider, 
jtulach@292:         ResetHandler reset, 
jtulach@292:         ShutdownHandler shutdown
jtulach@292:     )
jtulach@292:     // END: aserverinfo.regularcreate.withshutdown
jtulach@292:     {
jtulach@292:         return new ServerConnector(nameProvider, urlProvider, reset, shutdown);
jtulach@292:     }
jtulach@292: 
jtulach@292:     //
jtulach@292:     // private part
jtulach@292:     //
jtulach@292: 
jtulach@292:     private final NameProvider name;
jtulach@292:     private final URLProvider url;
jtulach@292:     private final ResetHandler reset;
jtulach@292:     private final ShutdownHandler shutdown;
jtulach@292: 
jtulach@292:     private ServerConnector(
jtulach@292:         NameProvider name, URLProvider url,
jtulach@292:         ResetHandler reset, ShutdownHandler shutdown
jtulach@292:     ) {
jtulach@292:         this.name = name;
jtulach@292:         this.url = url;
jtulach@292:         this.reset = reset;
jtulach@292:         this.shutdown = shutdown;
jtulach@292:     }
jtulach@292: 
jtulach@292: }