xmlBlaster 1.6.2 API

org.xmlBlaster.engine.admin
Interface I_AdminSubject

All Superinterfaces:
I_AdminUsage
All Known Subinterfaces:
SubjectInfoProtectorMBean
All Known Implementing Classes:
SubjectInfoProtector

public interface I_AdminSubject
extends I_AdminUsage

Declares available methods of a client for administration.

SNMP or telnet tools can access only the here declared properties.
This interface is implemented by SubjectInfo.java, delivering the meat.

Since:
0.79f
Author:
xmlBlaster@marcelruff.info

Method Summary
 java.lang.String getCreationDate()
          Get date when this subject was created.
 int getMaxSessions()
          Returns the maximum allowed login sessions for this subject.
 int getNumSessions()
          Returns how many login sessions this subject currently has.
 long getNumUpdate()
          How many messages where sent to all of this clients login sessions.
 I_AdminSession getSessionByPubSessionId(long pubSessionId)
          Navigate to a session instance.
 java.lang.String getSessionList()
          Get a list of all session names for this subject.
 java.lang.String[] getSessions()
          Get a list of all session names for this subject.
 MsgUnit[] getSubjectQueueEntries(java.lang.String querySpec)
          Query the history queue, can be peeking or consuming.
 long getSubjectQueueMaxMsgs()
          Returns the maximum allowed PtP messages in this queue.
 long getSubjectQueueNumMsgs()
          Returns how many PtP messages are currently in my subject queue.
 long getUptime()
          Get elapsed seconds since this subject was created.
 java.lang.String killClient()
          Destroy the client with all its sessions.
 java.lang.String[] peekSubjectMessages(int numOfEntries)
          Peek point to point messages from subject queue, they are not removed
 java.lang.String[] peekSubjectMessagesToFile(int numOfEntries, java.lang.String path)
          Peek messages from PtP subject queue and dump them to a file, they are not removed.
 void setMaxSessions(int max)
          Configure the maximum allowed login sessions for this subject.
 
Methods inherited from interface org.xmlBlaster.util.admin.I_AdminUsage
getUsageUrl, setUsageUrl, usage
 

Method Detail

getUptime

public long getUptime()
Get elapsed seconds since this subject was created.


getCreationDate

public java.lang.String getCreationDate()
Get date when this subject was created. This happens usually on a first login or on a first PtP message for this destination.

Returns:
The date string

getNumUpdate

public long getNumUpdate()
How many messages where sent to all of this clients login sessions.

Returns:
Number of updated messages send

getSubjectQueueNumMsgs

public long getSubjectQueueNumMsgs()
Returns how many PtP messages are currently in my subject queue.

Returns:
Number of messages in the queue

getSubjectQueueMaxMsgs

public long getSubjectQueueMaxMsgs()
Returns the maximum allowed PtP messages in this queue.

Returns:
The max messages supported

getNumSessions

public int getNumSessions()
Returns how many login sessions this subject currently has.

Returns:
Number of sessions of this subject

getMaxSessions

public int getMaxSessions()
Returns the maximum allowed login sessions for this subject.

Returns:
Max. number of sessions for this subject

setMaxSessions

public void setMaxSessions(int max)
Configure the maximum allowed login sessions for this subject.

Parameters:
max - The maximum number of sessions for this subject

getSessionList

public java.lang.String getSessionList()
Get a list of all session names for this subject.

Returns:
Comma separated list of sessions

getSessions

public java.lang.String[] getSessions()
Get a list of all session names for this subject.

Returns:
Array of session names

getSessionByPubSessionId

public I_AdminSession getSessionByPubSessionId(long pubSessionId)
Navigate to a session instance.

Parameters:
pubSessionId - The public session ID of the session to lookup
Returns:
The found session interface

killClient

public java.lang.String killClient()
                            throws XmlBlasterException
Destroy the client with all its sessions.

Returns:
The list of killed sessions (public session IDs)
Throws:
XmlBlasterException

peekSubjectMessages

public java.lang.String[] peekSubjectMessages(int numOfEntries)
                                       throws XmlBlasterException
Peek point to point messages from subject queue, they are not removed

Parameters:
numOfEntries - The number of messages to peek, taken from the front
Returns:
The dump of the messages
Throws:
XmlBlasterException

peekSubjectMessagesToFile

public java.lang.String[] peekSubjectMessagesToFile(int numOfEntries,
                                                    java.lang.String path)
                                             throws java.lang.Exception
Peek messages from PtP subject queue and dump them to a file, they are not removed.

Parameters:
numOfEntries - The number of messages to peek, taken from the front
path - The path to dump the messages to, it is automatically created if missing.
Returns:
The absolute file names dumped
Throws:
java.lang.Exception

getSubjectQueueEntries

public MsgUnit[] getSubjectQueueEntries(java.lang.String querySpec)
                                 throws XmlBlasterException
Query the history queue, can be peeking or consuming.

Parameters:
querySpec - Can be configured to be consuming e.g. "maxEntries=3&maxSize=-1&consumable=true&waitingDelay=0"
Throws:
XmlBlasterException
See Also:
The engine.qos.queryspec.QueueQuery requirement

xmlBlaster 1.6.2 API

Copyright © 1999-2007 The xmlBlaster.org contributers.