com.pcbsys.nirvana.nAdminAPI.nInterface Class Reference

Abstract Class nInterface. More...

Inheritance diagram for com.pcbsys.nirvana.nAdminAPI.nInterface:
com.pcbsys.nirvana.nAdminAPI.nBaseInterface com.pcbsys.nirvana.nAdminAPI.nHTTPInterface com.pcbsys.nirvana.nAdminAPI.nSocketInterface com.pcbsys.nirvana.nAdminAPI.nHTTPSInterface com.pcbsys.nirvana.nAdminAPI.nSSLInterface

Public Member Functions

virtual bool canAdvertise ()
 Will this interface be used by other realms to send client redirects to. More...
 
bool Equals (long aLong)
 used to sort interfaces
 
override bool Equals (object item)
 used to sort interfaces
 
virtual string getAdapaterAlias ()
 Returns the interfaces known alias's. More...
 
virtual string getAdapter ()
 Get the adapter that this interface will use. More...
 
virtual int getAuthTimeOut ()
 Returns the number of milliseconds that the remote client has to authenticate with the server before the server closes the communications with the client. More...
 
virtual int getBacklog ()
 The number of socket connect requests that the Operating System will queue before sending a reject to the remote client. More...
 
virtual int getPort ()
 Get the port that this interface will bind to at startup More...
 
virtual string getProtocol ()
 Returns the protocol string used by this interface. More...
 
virtual int getRecvBufferSize ()
 Return the socket buffer size in bytes used by this interface when receiving data More...
 
virtual int getSelectThreadSize ()
 Returns the number of select threads used by NIO More...
 
virtual int getSendBufferSize ()
 Return the socket buffer size in bytes used by this interface when sending data More...
 
virtual int getThreadCount ()
 Returns the current Thread Pool size that handles client socket connections. More...
 
virtual string getURL ()
 Get the URL that specifies this interface. More...
 
virtual nACL getViaList ()
 Retrieves the interfaces Via list. More...
 
virtual bool isAllowNIO ()
 Returns whether NIO is enabled on this interface More...
 
virtual bool isClientConnectionsAllowed ()
 Returns whether this interface can be used by clients to connect More...
 
virtual bool isInterRealmAllow ()
 Returns whether this interface is allowed to be used in inter realm / cluster communication More...
 
virtual bool lessThan (long aLong)
 used to sort interfaces
 
virtual bool lessThan (object item)
 used to sort interfaces
 
virtual void setAdapterAlias (string alias)
 Sets the interfaces alias. More...
 
virtual void setAdvertise (bool flag)
 Change the current advertise status for this interface More...
 
virtual void setAllowClientConnections (bool clientconnections)
 Sets whether this interface can accept client connections or not More...
 
virtual void setAllowNIO (bool allowNIO)
 Set whether NIO is enabled on the interface More...
 
virtual void setAuthTimeOut (int timeout)
 Changes the number of milliseconds that the remote client has to authenticate with the server. More...
 
virtual void setAutostart (bool flag)
 Change the current Autostart status for this interface More...
 
virtual void setBacklog (int backlog)
 Changes the number of connections to queue before the Operating System will send rejects to the remote client More...
 
virtual void setInterRealmAllow (bool interealmAllow)
 Sets whether this interface is allowed to be used in inter realm / cluster communication More...
 
virtual void setManager (nInterfaceManager im)
 Sets the interface manager More...
 
virtual void setRecvBufferSize (int myRecvBufferSize)
 Set the socket buffer size in bytes used by this interface when receiving data More...
 
virtual void setSelectThreadSize (int selectThreadSize)
 Sets the number of select threads used by NIO More...
 
virtual void setSendBufferSize (int mySendBufferSize)
 Set the socket buffer size in bytes used by this interface when sending data More...
 
virtual void setThreadCount (int count)
 Changes the thread pool size handling the client connections More...
 
virtual void setUseForProxyForward (bool useForproxyForward)
 Set whether or not to use proxy forwarding More...
 
virtual void setViaList (nACL acl)
 Commits the nACL object passed in with the Realm Server. More...
 
override string ToString ()
 Return a string representation of the interface details More...
 
virtual bool useForProxyForward ()
 Indicates whether or not to use proxy forwarding More...
 
virtual bool willAutostart ()
 Will this interface automatically be started when the Realm Server starts More...
 
- Public Member Functions inherited from com.pcbsys.nirvana.nAdminAPI.nBaseInterface
int getPort ()
 Get the port that this interface will bind to at startup More...
 
String getURL ()
 Get the URL that specifies this interface. It is made up from the protocol the adapter and port More...
 
void setAutostart (bool flag)
 Change the current Autostart status for this interface More...
 
bool willAutostart ()
 Will this interface automatically be started when the Realm Server starts More...
 

Detailed Description

Abstract Class nInterface.

This class exposes the common attributes to all Nirvana Realm interfaces.

Member Function Documentation

virtual bool com.pcbsys.nirvana.nAdminAPI.nInterface.canAdvertise ( )
virtual

Will this interface be used by other realms to send client redirects to.

Returns
Current value
virtual string com.pcbsys.nirvana.nAdminAPI.nInterface.getAdapaterAlias ( )
virtual

Returns the interfaces known alias's.

This is used by the server to tell other servers how to contact it if it is behind a NAT or Proxy server. It is specified as a HOST:PORT syntax

  • Returns
    String alias
virtual string com.pcbsys.nirvana.nAdminAPI.nInterface.getAdapter ( )
virtual

Get the adapter that this interface will use.

Reserved interfaces are

  • 0.0.0.0 - Bind to all physical interfaces on the machine 127.0.0.1 - Bind to local loopback
Returns
The current interface

Reimplemented from com.pcbsys.nirvana.nAdminAPI.nBaseInterface.

virtual int com.pcbsys.nirvana.nAdminAPI.nInterface.getAuthTimeOut ( )
virtual

Returns the number of milliseconds that the remote client has to authenticate with the server before the server closes the communications with the client.

Returns
The current timeout
virtual int com.pcbsys.nirvana.nAdminAPI.nInterface.getBacklog ( )
virtual

The number of socket connect requests that the Operating System will queue before sending a reject to the remote client.

Returns
The current setting
virtual int com.pcbsys.nirvana.nAdminAPI.nInterface.getPort ( )
virtual

Get the port that this interface will bind to at startup

Returns
Integer value of the port
virtual string com.pcbsys.nirvana.nAdminAPI.nInterface.getProtocol ( )
virtual

Returns the protocol string used by this interface.

Can be one of nsp, nsps, nhps or nhp

Returns
The protocol used by this interface
virtual int com.pcbsys.nirvana.nAdminAPI.nInterface.getRecvBufferSize ( )
virtual

Return the socket buffer size in bytes used by this interface when receiving data

Returns
the inbound socket buffer size in bytes used by this interface
virtual int com.pcbsys.nirvana.nAdminAPI.nInterface.getSelectThreadSize ( )
virtual

Returns the number of select threads used by NIO

Returns
the number of select threads used
virtual int com.pcbsys.nirvana.nAdminAPI.nInterface.getSendBufferSize ( )
virtual

Return the socket buffer size in bytes used by this interface when sending data

Returns
the outbound socket buffer size in bytes used by this interface
virtual int com.pcbsys.nirvana.nAdminAPI.nInterface.getThreadCount ( )
virtual

Returns the current Thread Pool size that handles client socket connections.

Depending on the number of connections/second this size should be around 1 or 2 anything more may not really gain any improvement

Returns
The current size
virtual string com.pcbsys.nirvana.nAdminAPI.nInterface.getURL ( )
virtual

Get the URL that specifies this interface.

It is made up from the protocol the adapter and port

Returns
URL string
virtual nACL com.pcbsys.nirvana.nAdminAPI.nInterface.getViaList ( )
virtual

Retrieves the interfaces Via list.

This list is contained in a nACL object.

nACL

Returns
nACL
virtual bool com.pcbsys.nirvana.nAdminAPI.nInterface.isAllowNIO ( )
virtual

Returns whether NIO is enabled on this interface

Returns
if NIO is enabled
virtual bool com.pcbsys.nirvana.nAdminAPI.nInterface.isClientConnectionsAllowed ( )
virtual

Returns whether this interface can be used by clients to connect

Returns
whether this interface is allowed for client communication
virtual bool com.pcbsys.nirvana.nAdminAPI.nInterface.isInterRealmAllow ( )
virtual

Returns whether this interface is allowed to be used in inter realm / cluster communication

Returns
whether this interface is allowed for cluster communication
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setAdapterAlias ( string  alias)
virtual

Sets the interfaces alias.

  • This string is of the format HOST:PORT where HOST is the alias interface and port is the number used to communicate with the server.
Parameters
aliasan alias hostname for the interface
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setAdvertise ( bool  flag)
virtual

Change the current advertise status for this interface

Parameters
flagTrue or False
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setAllowClientConnections ( bool  clientconnections)
virtual

Sets whether this interface can accept client connections or not

Parameters
clientconnectionswhether this interface can be used by clients
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setAllowNIO ( bool  allowNIO)
virtual

Set whether NIO is enabled on the interface

Parameters
allowNIOwhether NIO is enabled
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setAuthTimeOut ( int  timeout)
virtual

Changes the number of milliseconds that the remote client has to authenticate with the server.

Parameters
timeouttime in milliseconds
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setAutostart ( bool  flag)
virtual

Change the current Autostart status for this interface

Parameters
flagTrue or False
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setBacklog ( int  backlog)
virtual

Changes the number of connections to queue before the Operating System will send rejects to the remote client

Parameters
backlogMust be between 1 and 100
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setInterRealmAllow ( bool  interealmAllow)
virtual

Sets whether this interface is allowed to be used in inter realm / cluster communication

Parameters
interealmAllowwhether this interface is allowed for cluster commincation
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setManager ( nInterfaceManager  im)
virtual

Sets the interface manager

Parameters
imThe nInterFaceManager to set
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setRecvBufferSize ( int  myRecvBufferSize)
virtual

Set the socket buffer size in bytes used by this interface when receiving data

Parameters
myRecvBufferSizethe inbound socket buffer size in bytes used by this interface
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setSelectThreadSize ( int  selectThreadSize)
virtual

Sets the number of select threads used by NIO

Parameters
selectThreadSizethe number of select threads used
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setSendBufferSize ( int  mySendBufferSize)
virtual

Set the socket buffer size in bytes used by this interface when sending data

Parameters
mySendBufferSizethe size to set the outbound buffer size to
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setThreadCount ( int  count)
virtual

Changes the thread pool size handling the client connections

Parameters
countMust be between 1 and 5 inclussive
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setUseForProxyForward ( bool  useForproxyForward)
virtual

Set whether or not to use proxy forwarding

Parameters
useForproxyForwardset to true if proxy forwarding is to be used
virtual void com.pcbsys.nirvana.nAdminAPI.nInterface.setViaList ( nACL  acl)
virtual

Commits the nACL object passed in with the Realm Server.

This causes these nInterfaceViaEntry to be active once the function returns. The nACL object can be retrieved by calling the getViaList() function which returns the interface current VIA list.

Parameters
aclA nACL containing nInterfaceViaEntry
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
override string com.pcbsys.nirvana.nAdminAPI.nInterface.ToString ( )

Return a string representation of the interface details

Returns
a string representation of the interface details
virtual bool com.pcbsys.nirvana.nAdminAPI.nInterface.useForProxyForward ( )
virtual

Indicates whether or not to use proxy forwarding

<return> true if should use proxy forwarding </return>

virtual bool com.pcbsys.nirvana.nAdminAPI.nInterface.willAutostart ( )
virtual

Will this interface automatically be started when the Realm Server starts

Returns
Current value