Socket Factory and Event Interfaces

Socket Factory Interfaces

Overview

The ProSyst Util Bundle exports the com.prosyst.util.net package, which can be used for developing socket-provider services. Besides the interfaces, the package contains their default implementations.

• The SocketFactory interface represents a factory that opens sockets. Sockets can be used in client application that communicate over TCP/IP. This interface can be implemented to suit best the communication in a specific TCP/IP network. In addition, support of sockets over a proxy server can be provided.

  The ServerSocketFactory interface contains methods for opening server sockets and can be implemented for server connection over TCP/IP.

  The default implementation of both SocketFactory and ServerSocketFactory is PlainSocketFactory, which provides sockets and server sockets for plain TCP/IP communication.

• Another useful class is ProxySocket which represents a socket for connection to a URL through an HTTP proxy server.
• The com.prosyst.util.net.SecureSocket class can be used for checking the certificate chain of the other side, involved in the communication. Currently, this class is supported by TLS server and client bundles included in the mBS Security package.

System Properties

Use the mbs.putil.unix_new_line system property to specify if a com.prosyst.util.net.ProxySocket should use a UNIX new line or a Windows new line, depending on the proxy server. If the property is true, the ProxySocket will use "\n" new line as in UNIX. If the property is false or is missing, the ProxySocket will use "\r\n" as in Windows.

Event Interfaces

The com.prosyst.util.event.EventCollector interface of the ProSyst Util Bundle allows you to create services or other types of modules that provide definition and dispatching of events to interested listeners. It can be used when a direct connection between the event source and the event listener cannot be established (for example if the listener works in a different VM).

The com.prosyst.util.event.EventsManager interface can be implemented in order to manage registration and notification of event listeners for miscellaneous events. Listeners are provided as implementations of the com.prosyst.util.event.EventListener interface. Events are represented by BasicEvent objects which can related to changes in the state of the framework, of a bundle or of a service.

Tip: An EventsManager implementation is provided by the PMP, which is capable of remote exchange of events over PMP.