Class ServerShell

    • Constructor Detail

      • ServerShell

        public ServerShell​(java.io.File configFileParam)
                    throws java.io.IOException,
                           PropException
        Constructor.
        Parameters:
        configFileParam - The configuration file, null for default.
        Throws:
        java.io.IOException - For load failure.
        PropException - For property errors.
    • Method Detail

      • updateWebServerRoot

        public static void updateWebServerRoot​(java.io.File dirHint)
        Update the web server root for the license system.
        Parameters:
        dirHint - The directory hint might be non-null. If so, that one should be used.
      • getInstance

        public static ServerShell getInstance()
        Gets the instance of the main server. If the server never has been started, it will be started before returning the instance.
        Returns:
        null if it is stopped.
      • getInstance

        protected static ServerShell getInstance​(java.lang.Class<ServerShell> server)
        Gets the instance of the main server. If the server never has been started, it will be started before returning the instance.
        Returns:
        null if it is stopped.
      • _getState

        public static IServer.State _getState()
        Gets the state of the server.
        Returns:
        The server state: STARTING, STARTED, STOPPING or STOPPED.
      • _unregisterApplication

        public static void _unregisterApplication​(java.lang.String jndiName,
                                                  java.lang.Object injector)
        Unregisters an application with the server.
        Parameters:
        jndiName - The full JNDI name of the application.
        injector - The instance of the application injector.
      • _registerApplication

        public static void _registerApplication​(java.lang.String jndiName,
                                                java.lang.Object injector)
        Registers an application with the server.
        Parameters:
        jndiName - The full JNDI name of the application.
        injector - The instance of the application injector.
      • registerRegionLocationServiceProviders

        public static void registerRegionLocationServiceProviders​(ServerSettings settings,
                                                                  boolean isTestMode)
        Registers the Region Location Service Providers.
        Parameters:
        settings - The settings.
        isTestMode - Flag for test mode.
        Throws:
        java.lang.IllegalStateException - For invalid server states.
      • shutdownRegionLocationServiceProviders

        public static void shutdownRegionLocationServiceProviders()
        Shuts down the Region Location Service Providers.

        This method is used for testing and not by the server.

        Throws:
        java.lang.IllegalStateException - For invalid state.
      • initializeURNFactory

        public static void initializeURNFactory()
        Initializes the URN factory along with its providers.
      • getCurrentDirectory

        public java.io.File getCurrentDirectory()
        Gets the server current directory.
        Returns:
        The current directory (canonical form).
      • getStartTime

        public final long getStartTime()
        Gets the server's start time (not the creation time).
        Returns:
        The start time in milliseconds since the Epoch, zero if not yet started.
      • getExecutorService

        public final java.util.concurrent.ExecutorService getExecutorService()
        Gets the Server ExecutorService.
        Specified by:
        getExecutorService in interface IAppLoader
      • getServerThreadGroup

        public final java.lang.ThreadGroup getServerThreadGroup()
        Gets the ThreadGroup for server threads.
      • getState

        public final IServer.State getState()
        Gets the server state.
        Specified by:
        getState in interface IServer
        Returns:
        The server state: STARTING, STARTED, STOPPING or STOPPED.
      • getActiveUserSessions

        public final ActiveUserSessions getActiveUserSessions()
        The active user sessions.
        Returns:
        The instance controlling the active user sessions, null if server hasn't been started.
      • loadPluginsAndConfig

        protected final void loadPluginsAndConfig()
                                           throws java.lang.Throwable
        Performs initial setup, loading plugins and the configuration file.
        Throws:
        java.lang.Throwable
      • startServer

        public final void startServer()
                               throws java.lang.Throwable
        Processes server start-up asynchronously.
        Specified by:
        startServer in interface IServer
        Throws:
        java.lang.Throwable - for startup errors.
      • getServerLogger

        public ServerLogger getServerLogger()
        Gets the server logger instance.
      • flushStartupLog

        protected void flushStartupLog()
        Flushes a potential start-up logging to console for exceptions causing server not to initialize the logging system.
      • registerRequestPrinter

        public boolean registerRequestPrinter​(java.lang.String target,
                                              IWebServerRequestPrinter processor)
        Registers a new request printer.
        Specified by:
        registerRequestPrinter in interface IServer
        Parameters:
        target - The target URL, always starting with "/" and doesn't contain the query.
        processor - The print processor.
        Returns:
        true if added successfully, false if the print processor already exists or the server is not started yet.
      • unregisterRequestPrinter

        public boolean unregisterRequestPrinter​(java.lang.String target,
                                                IWebServerRequestPrinter processor)
        Unregister a previously registered request printer.
        Specified by:
        unregisterRequestPrinter in interface IServer
        Parameters:
        target - The target URL, always starting with "/" and doesn't contain the query.
        processor - The print processor.
        Returns:
        true if removed successfully, false if the print processor does not exist or doesn't match, or the server is not yet started.
      • getExternalWebServerBaseURL

        public java.lang.String getExternalWebServerBaseURL()
        Attempts to get the default external host address from the current thread's context.

        Note: the SessionInfo instance will be attempted to be retrieved from the current thread and used for the external server address, including protocol (http:// or https://). Note that if the iiziServer is behind a proxy that handles SSL, the protocol returned here would be "http://" if not configured properly in the server configuration.

        Returns:
        The external host address, including protocol (http:// or https://) and potentially a port as (:8080), or null if it cannot be established. The string never ends with a '/'.
      • getEmailVerificationURL

        public java.lang.String getEmailVerificationURL​(BasicUserInfo bui,
                                                        java.lang.String email,
                                                        java.lang.String externalWebServerBaseURL)
        Gets a verification URL for an email address. This URL is used to send a mail to the email in question with the link using this URL. When the user clicks on the link, the email gets verified in the database and all logging is handled by the server.

        Note: if the parameter externalHostAddress is null, the SessionInfo instance will be attempted to be retrieved from the current thread and used for the external server address, including protocol (http:// or https://). Note that if the iiziServer is behind a proxy that handles SSL, the protocol returned here would be "http://" if not configured properly in the server configuration.

        If the SessionInfo cannot be located, the server's external URL configuration is used.

        Parameters:
        bui - The basic user information.
        email - The email in question.
        externalWebServerBaseURL - The external base URL for the web server, e.g. "https://lic.mindus.co", use null for default. The default address is retrieved using getExternalWebServerBaseURL().
        Returns:
        The URL, or null if the external host address cannot be created.

        PLEASE NOTE THAT IF THE DOMAIN NAME FAILS TO BE RETRIEVED, THE "url" DOES NOT CONTAIN THAT INFORMATION. It will then just be a path such as "/iizi-email-verification?...".

        The return URL is null if the SHA-256 message digest fails to be created due to Java not having unlimited security configured. If this is the case, an error message is logged prior to returning.

      • getServerConfigFile

        public final java.io.File getServerConfigFile()
        Gets the Server Config File.
        Returns:
        The config file used to start the server with.
      • loadServerConfig

        protected final void loadServerConfig()
                                       throws java.io.IOException,
                                              PropException
        Loads or reloads the server config and starts the WSFile provider engine.
        Throws:
        java.io.IOException - For load failure.
        PropException - For property errors.
      • getServerSettings

        public ServerSettings getServerSettings()
        Gets the container for server settings.
      • configureSessionMgr

        public void configureSessionMgr()
        Configures the client session manager with the settings for idle timeout, dormant time and heartbeat interval.
      • saveServerConfig

        public boolean saveServerConfig()
                                 throws java.io.IOException
        Saves the Server Properties if required, creating a backup file of the previous configuration as "filename-DD MMM YYYY hh:mm:ss.SSS.iiziServer".
        Returns:
        true for successful save, false for no change.
        Throws:
        java.io.IOException - For load failure.
      • loadApplications

        public abstract void loadApplications()
                                       throws java.lang.Throwable
        Called to load the applications.
        Specified by:
        loadApplications in interface IServer
        Throws:
        java.lang.Throwable - for start-up errors.
      • getApplication

        public final AppFactory getApplication​(java.lang.String id)
        Gets an application that has been registered with an ID.
        Parameters:
        id - The application ID.
        Returns:
        The application factory, or null if not registered.
      • getApplications

        public final AppFactory[] getApplications()
        Gets the applications that are loaded and registered.
        Returns:
        The application factories loaded.
      • onApplicationSessionStarted

        public void onApplicationSessionStarted​(AppSessionGyro appGyro)
        Called when an application is instantiated and started by a user session.
        Parameters:
        appGyro - The application session.
      • onApplicationSessionStopped

        public void onApplicationSessionStopped​(AppSessionGyro appGyro)
        Called when an application is stopped.
        Parameters:
        appGyro - The application session.
      • addDisposeListener

        public boolean addDisposeListener​(IServerDisposeListener listener)
        Adds a server dispose. Calling this method multiple times with the same listener will have no effect (but to return false).
        Specified by:
        addDisposeListener in interface IServer
        Parameters:
        listener - The listener to add.
        Returns:
        true if the listener was added, false otherwise.
        Throws:
        java.lang.NullPointerException - If the listener is null.
      • removeDisposeListener

        public boolean removeDisposeListener​(IServerDisposeListener listener)
        Removes a server dispose listener.
        Specified by:
        removeDisposeListener in interface IServer
        Parameters:
        listener - The listener to remove.
        Returns:
        true if listener is successfully removed, false otherwise.
      • onStartServer

        public void onStartServer()
                           throws java.lang.Throwable
        Called to initialize the server.
        Specified by:
        onStartServer in interface IServer
        Throws:
        java.lang.Throwable - for start-up errors.
      • getWorker

        protected final Worker getWorker()
        Gets the server worker.
      • dispose

        public final boolean dispose()
        Disposes of the server, e.g. at shut-down. This dispose call will wait until the server has shut-down successfully.
        Specified by:
        dispose in interface IServer
        Returns:
        true for success, false if already disposed of or stopping/disposing.
      • onDispose

        protected void onDispose()
        Called prior to disposing. Override to process.
      • onDisposed

        protected void onDisposed()
        Called after disposing. Override to process.
      • getPropertyFactory

        public final PropFactory getPropertyFactory()
        Gets the server property factory.
      • loadFile

        public final PropCnr loadFile​(java.io.File file)
                               throws java.io.IOException,
                                      PropException
        Loads a property file.
        Specified by:
        loadFile in interface IAppLoader
        Parameters:
        file - The file to load.
        Returns:
        A Property container.
        Throws:
        java.io.IOException - For file errors.
        PropException - For property errors.
      • loadFile

        public final PropCnr loadFile​(java.lang.String fileName,
                                      java.io.InputStream inputStream)
                               throws java.io.IOException,
                                      PropException
        Loads a property file.
        Specified by:
        loadFile in interface IAppLoader
        Parameters:
        fileName - The file name for logging.
        inputStream - The file input stream.
        Returns:
        A Property container.
        Throws:
        java.io.IOException - For file errors.
        PropException - For property errors.
      • saveFile

        public final void saveFile​(java.io.File file,
                                   PropCnr cnr)
                            throws java.io.IOException,
                                   PropException
        Saves a property file.
        Parameters:
        file - The file to load.
        cnr - The property container to save.
        Throws:
        java.io.IOException - For file errors.
        PropException - For property errors.
      • getAccessibleEnvironments

        public boolean getAccessibleEnvironments​(HttpServletRequest request,
                                                 java.util.List<ServerConfigEnvProps> envs)
        Gets the environments that are supported for the request. Pass in an empty ArrayList of envs that is filled in.
        Parameters:
        request - The HTTP request.
        envs - The environment list is filled in upon return.
        Returns:
        true if the request is "valid", false if the "host" header doesn't match and that each environment should be interrogated.
      • loadPlugins

        public final java.util.List<IPluginDescriptor<?>> loadPlugins​(java.lang.String names)
                                                               throws java.io.IOException
        Loads required plug-in's.

        Each plug-in must have a class called "name.server.Descriptor" that implement the interface com.iizix.IPluginDescriptor available.

        The plug-in definition should be found at the "name/schema/properties.xml", but the iiziGo modules have the "iizigo" module instead of "iizix". To figure out translation of names, a class called "name.server.Descriptor" is loaded and should implement the interface

        Specified by:
        loadPlugins in interface IAppLoader
        Parameters:
        names - The plug-in name, e.g. "com.iizigo.db,com.iizigo.term,com.iizigo.ws".
        Returns:
        The list of plug-in descriptors.
        Throws:
        java.io.IOException - If a plug-in failed to load.
      • addModule

        public boolean addModule​(IServerModule<?> module)
        Adds a server module for processing. The module can have an end point constructor that is added during initialization.
        Specified by:
        addModule in interface IServer
        Parameters:
        module - The server module.
        Returns:
        true for success, false if already added.
      • removeModule

        public boolean removeModule​(IServerModule<?> module)
        Removes a server module for processing. This will unregister a potential end point constructor and dispose of the module.
        Specified by:
        removeModule in interface IServer
        Parameters:
        module - The server module.
        Returns:
        true for success, false if already removed.
      • registerEndPointConstructor

        protected final boolean registerEndPointConstructor​(IEndPointConstructor<?> epc)
        Registers an end point constructor.
        Parameters:
        epc - The end point constructor.
        Returns:
        true for success, false for failure e.g. epc is null or it is already registered.
      • unregisterEndPointConstructor

        protected final boolean unregisterEndPointConstructor​(IEndPointConstructor<?> epc)
        Unregisters an end point constructor.
        Parameters:
        epc - The end point constructor.
        Returns:
        true for success, false for failure.
      • isRequestURIAccepted

        public final java.lang.Object isRequestURIAccepted​(IWebSocketComm comm,
                                                           java.lang.String uri,
                                                           java.util.Map<java.lang.String,​java.util.List<java.lang.String>> headerFields)
        Called to check if a request URI can be accepted.
        Specified by:
        isRequestURIAccepted in interface WebSocketAcceptor
        Parameters:
        comm - The WebSocket communication instance.
        uri - The request URI, formatted as e.g. "/something/more.ws?query-params".
        headerFields - HTTP header fields.
        Returns:
        Object an object that is attached to the communications, or null if the URI is not accepted.
      • getEndPointsInstances

        public final IEndPoint[] getEndPointsInstances()
        Gets an array of all end points. Avoid this method as it causes unnecessary garbage collection, use getEndPointsCollection instead.
        Specified by:
        getEndPointsInstances in interface IServer
        Returns:
        An array of IEndPoint instances.
      • onEndPointDisposed

        public final void onEndPointDisposed​(IEndPoint endPoint)
        Called when an end point is disposed of.
        Specified by:
        onEndPointDisposed in interface IServer
      • addEndPointListener

        public final IEndPoint[] addEndPointListener​(IEndPointListener listener)
        Adds a listener of end point create/dispose and retrieves the list of current end points. Calling this method several times with the same listener does not add a new one, it is similar to calling getEndPointInstances().
        Specified by:
        addEndPointListener in interface IServer
        Parameters:
        listener - The end point listener.
        Returns:
        An array of EndPoint instances.
      • removeEndPointListener

        public final boolean removeEndPointListener​(IEndPointListener listener)
        Adds a listener of end point create/dispose and retrieves the list of current end points. Calling this method several times with the same listener does not add a new one, it is similar to calling getEndPointInstances().
        Specified by:
        removeEndPointListener in interface IServer
        Parameters:
        listener - The end point listener.
        Returns:
        true for success, false if not added as listener.
      • getKStringInfoProvider

        public final IKStringInfoProvider getKStringInfoProvider()
        Retrieves the KStringInfoProvider for the calling thread. The Client Session Gyro is looked up to process it.
        Specified by:
        getKStringInfoProvider in interface IKStringInfoProviderHolder
        Returns:
        The KString information provider instance, or null if not possible.
      • registerApplication

        public void registerApplication​(java.lang.String jndiName,
                                        java.lang.Object injector)
        Registers an application with the server.
        Parameters:
        jndiName - The full JNDI name of the application.
        injector - The instance of the application injector.
      • unregisterApplication

        public void unregisterApplication​(java.lang.String jndiName,
                                          java.lang.Object injector)
        Unregisters an application with the server.
        Parameters:
        jndiName - The full JNDI name of the application.
        injector - The instance of the application injector.
      • getHistory

        public final OSSystemInfo.HistoryEntry<UserInfoHistoryEntry>[] getHistory​(long start)
        Gets the history entries gathered between a date up to the last available entry. The history entries are gathered at specific interval defined at start of history.
        Parameters:
        start - The start time for the events in milliseconds since the Epoch, or zero for all history entries.
        Returns:
        The entries, possibly empty array.
      • initializeCompressedFiles

        protected void initializeCompressedFiles()
                                          throws java.io.IOException
        Initializes and compresses the HTML files and all sources and CSS files loaded from there.
        Throws:
        java.io.IOException - For I/O errors.
      • getSourceResolver

        public ISourceResolver getSourceResolver()
        Gets the source file resolver.
        Returns:
        The instance used to resolve file names.
      • getFileProviderEngine

        public WSFileProviderEngine getFileProviderEngine()
        Gets the WSFile provider engine.

        The engine is initialized as soon as the server configuration file has been loaded, before any additional processing is done.

        Returns:
        The file provider engine, null if not yet initialized.
      • getWebThumbs

        public WebThumbs getWebThumbs()
                               throws java.io.IOException
        Gets the instance of the WebThumbs.
        Returns:
        The singleton (per server instance).
        Throws:
        java.io.IOException - For I/O errors when creating the WebThumbs directory for persistent images.
      • getWebLogos

        public WebLogos getWebLogos()
                             throws java.io.IOException
        Gets the instance of the WebLogos.
        Returns:
        The singleton (per server instance).
        Throws:
        java.io.IOException - For I/O errors when creating the WebLogos directory for persistent images.
      • addFileUploader

        public void addFileUploader​(IWSUploaderAcceptor endPoint)
        Adds a new web file loader acceptor for an end point.
        Parameters:
        endPoint - The end point.
        Throws:
        java.lang.ClassCastException - If the end point is not configurable to receive file uploads.
        java.lang.IllegalStateException - If the end point is already added.
      • removeFileUploader

        public void removeFileUploader​(IWSUploaderAcceptor endPoint)
        Removes a new web file loader acceptor for an end point.
        Parameters:
        endPoint - The end point.
      • getWSUploaderService

        public IWSUploaderService getWSUploaderService()
        Gets the web service file uploader service.
        Returns:
        The instance of the web service file uploader service.
      • doCompressNormalHTML

        public abstract boolean doCompressNormalHTML()
        Flag indicating the normal HTML files needs compression along with CSS minify and JS compression.

        The files are typically: iiziApp.html and iiziVSViewer.html.

        Returns:
        true by default, override to return false (e.g. for internal development).
      • getWebServerCompression

        public abstract IWebServerCompression getWebServerCompression()
        Gets the web server compression interface.
        Returns:
        The instance of the interface implemented by the web server.
      • getWebServerMapping

        public java.io.File getWebServerMapping​(java.lang.String mappedFile)
        Gets the map of web server mappings for files.
        Parameters:
        mappedFile - The file to map.
        Returns:
        The mapping from String (such as "dojo.root" or "iiziRun.root") to File Returns null if not found.
      • getETag

        public java.lang.String getETag​(java.io.File file)
        Gets the map of web server mappings for files.
        Parameters:
        file - The file.
        Returns:
        The weak ETag for the resource.mapping from String (such as "dojo.root" or "iiziRun.root") to File Returns null if not found.