de.e_nexus.jabber

Class JabberBuilder.JabberServer

java.lang.Object

de.e_nexus.jabber.JabberBuilder.JabberServer

Enclosing class:

JabberBuilder

public static final class JabberBuilder.JabberServer
extends Object

The XMPP-Server instance.

Constructor Summary

Constructors

Constructor and Description
JabberBuilder.JabberServer()

Method Summary

Methods

Modifier and Type	Method and Description
void	broadcast(String message) Sends a broadcast message to all users.
static JabberBuilder.JabberServer	getServer() Lazy Singleton.
boolean	isRunning() Checks if the Server is running.
void	start(String certAbsoluteFilename, String certKey, String hostname, String serverPort) The offical server start with a cascading-fault-barrier around.
void	stop() Stops the XMPP-Server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JabberBuilder.JabberServer

public JabberBuilder.JabberServer()

Method Detail

getServer

public static JabberBuilder.JabberServer getServer()

Lazy Singleton. Shall not be mocked. Its a server, dont unit-test it, integration-test it instead.

Returns:

The singleton-Instance of JabberBuilder.JabberServer.

broadcast

public void broadcast(String message)
               throws NullPointerException

Sends a broadcast message to all users.

Internally synchronize about the users. Because someone may restart the server meanwhile a broadcast is running.

Some lazy programmers missed to specify unchecked-exceptions in method signatures.

Parameters:

message - The message to broadcast, not null and \n\r as line-break.

Throws:

NullPointerException - If the Server stops meanwhile or some other undocumentated cases.

start

public void start(String certAbsoluteFilename,
         String certKey,
         String hostname,
         String serverPort)
           throws Exception

The offical server start with a cascading-fault-barrier around.

Parameters:

certAbsoluteFilename - The Filename of the .jks-file.

certKey - The key of the .jks-file.

hostname - The Hostname, usually not including subdomains, except explicits.

serverPort - The Port. In combination with the Hostname, a Socket.

Throws:

Exception - If some unexpected has been happend.

stop

public void stop()
          throws IllegalStateException

Stops the XMPP-Server.

Throws:

IllegalStateException

isRunning

public boolean isRunning()

Checks if the Server is running.

Returns:

true if the Server is running. false if not.