org.opends.server.admin.std.client
Interface DebugLogPublisherCfgClient

All Superinterfaces:
ConfigurationClient, LogPublisherCfgClient
All Known Subinterfaces:
FileBasedDebugLogPublisherCfgClient

public interface DebugLogPublisherCfgClient
extends LogPublisherCfgClient

A client-side interface for reading and modifying Debug Log Publisher settings.

Debug Log Publishers are responsible for distributing debug log messages from the debug logger to a destination.


Method Summary
<C extends DebugTargetCfgClient>
C
createDebugTarget(ManagedObjectDefinition<C,? extends DebugTargetCfg> d, java.lang.String name, java.util.Collection<DefaultBehaviorException> exceptions)
          Creates a new Debug Target.
 ManagedObjectDefinition<? extends DebugLogPublisherCfgClient,? extends DebugLogPublisherCfg> definition()
          Get the configuration definition associated with this Debug Log Publisher.
 DebugTargetCfgClient getDebugTarget(java.lang.String name)
          Gets the named Debug Target.
 java.util.SortedSet<DebugLogPublisherCfgDefn.DefaultDebugCategory> getDefaultDebugCategory()
          Gets the "default-debug-category" property.
 DebugLogPublisherCfgDefn.DefaultDebugLevel getDefaultDebugLevel()
          Gets the "default-debug-level" property.
 int getDefaultThrowableStackFrames()
          Gets the "default-throwable-stack-frames" property.
 java.lang.String getJavaClass()
          Gets the "java-class" property.
 boolean isDefaultIncludeThrowableCause()
          Gets the "default-include-throwable-cause" property.
 boolean isDefaultOmitMethodEntryArguments()
          Gets the "default-omit-method-entry-arguments" property.
 boolean isDefaultOmitMethodReturnValue()
          Gets the "default-omit-method-return-value" property.
 java.lang.String[] listDebugTargets()
          Lists the Debug Targets.
 void removeDebugTarget(java.lang.String name)
          Removes the named Debug Target.
 void setDefaultDebugCategory(java.util.Collection<DebugLogPublisherCfgDefn.DefaultDebugCategory> values)
          Sets the "default-debug-category" property.
 void setDefaultDebugLevel(DebugLogPublisherCfgDefn.DefaultDebugLevel value)
          Sets the "default-debug-level" property.
 void setDefaultIncludeThrowableCause(java.lang.Boolean value)
          Sets the "default-include-throwable-cause" property.
 void setDefaultOmitMethodEntryArguments(java.lang.Boolean value)
          Sets the "default-omit-method-entry-arguments" property.
 void setDefaultOmitMethodReturnValue(java.lang.Boolean value)
          Sets the "default-omit-method-return-value" property.
 void setDefaultThrowableStackFrames(java.lang.Integer value)
          Sets the "default-throwable-stack-frames" property.
 void setJavaClass(java.lang.String value)
          Sets the "java-class" property.
 
Methods inherited from interface org.opends.server.admin.std.client.LogPublisherCfgClient
isEnabled, setEnabled
 
Methods inherited from interface org.opends.server.admin.ConfigurationClient
commit, properties
 

Method Detail

definition

ManagedObjectDefinition<? extends DebugLogPublisherCfgClient,? extends DebugLogPublisherCfg> definition()
Get the configuration definition associated with this Debug Log Publisher.

Specified by:
definition in interface ConfigurationClient
Specified by:
definition in interface LogPublisherCfgClient
Returns:
Returns the configuration definition associated with this Debug Log Publisher.

getDefaultDebugCategory

java.util.SortedSet<DebugLogPublisherCfgDefn.DefaultDebugCategory> getDefaultDebugCategory()
Gets the "default-debug-category" property.

The debug message categories to be logged when none of the defined targets match the message.

Returns:
Returns the values of the "default-debug-category" property.

setDefaultDebugCategory

void setDefaultDebugCategory(java.util.Collection<DebugLogPublisherCfgDefn.DefaultDebugCategory> values)
                             throws IllegalPropertyValueException
Sets the "default-debug-category" property.

The debug message categories to be logged when none of the defined targets match the message.

Parameters:
values - The values of the "default-debug-category" property.
Throws:
IllegalPropertyValueException - If one or more of the new values are invalid.

getDefaultDebugLevel

DebugLogPublisherCfgDefn.DefaultDebugLevel getDefaultDebugLevel()
Gets the "default-debug-level" property.

The lowest severity level of debug messages to log when none of the defined targets match the message.

Returns:
Returns the value of the "default-debug-level" property.

setDefaultDebugLevel

void setDefaultDebugLevel(DebugLogPublisherCfgDefn.DefaultDebugLevel value)
                          throws IllegalPropertyValueException
Sets the "default-debug-level" property.

The lowest severity level of debug messages to log when none of the defined targets match the message.

Parameters:
value - The value of the "default-debug-level" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

isDefaultIncludeThrowableCause

boolean isDefaultIncludeThrowableCause()
Gets the "default-include-throwable-cause" property.

Indicates whether to include the cause of exceptions in exception thrown and caught messages logged by default.

Returns:
Returns the value of the "default-include-throwable-cause" property.

setDefaultIncludeThrowableCause

void setDefaultIncludeThrowableCause(java.lang.Boolean value)
                                     throws IllegalPropertyValueException
Sets the "default-include-throwable-cause" property.

Indicates whether to include the cause of exceptions in exception thrown and caught messages logged by default.

Parameters:
value - The value of the "default-include-throwable-cause" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

isDefaultOmitMethodEntryArguments

boolean isDefaultOmitMethodEntryArguments()
Gets the "default-omit-method-entry-arguments" property.

Indicates whether to include method arguments in debug messages logged by default.

Returns:
Returns the value of the "default-omit-method-entry-arguments" property.

setDefaultOmitMethodEntryArguments

void setDefaultOmitMethodEntryArguments(java.lang.Boolean value)
                                        throws IllegalPropertyValueException
Sets the "default-omit-method-entry-arguments" property.

Indicates whether to include method arguments in debug messages logged by default.

Parameters:
value - The value of the "default-omit-method-entry-arguments" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

isDefaultOmitMethodReturnValue

boolean isDefaultOmitMethodReturnValue()
Gets the "default-omit-method-return-value" property.

Indicates whether to include the return value in debug messages logged by default.

Returns:
Returns the value of the "default-omit-method-return-value" property.

setDefaultOmitMethodReturnValue

void setDefaultOmitMethodReturnValue(java.lang.Boolean value)
                                     throws IllegalPropertyValueException
Sets the "default-omit-method-return-value" property.

Indicates whether to include the return value in debug messages logged by default.

Parameters:
value - The value of the "default-omit-method-return-value" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getDefaultThrowableStackFrames

int getDefaultThrowableStackFrames()
Gets the "default-throwable-stack-frames" property.

Indicates the number of stack frames to include in the stack trace for method entry and exception thrown messages.

Returns:
Returns the value of the "default-throwable-stack-frames" property.

setDefaultThrowableStackFrames

void setDefaultThrowableStackFrames(java.lang.Integer value)
                                    throws IllegalPropertyValueException
Sets the "default-throwable-stack-frames" property.

Indicates the number of stack frames to include in the stack trace for method entry and exception thrown messages.

Parameters:
value - The value of the "default-throwable-stack-frames" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getJavaClass

java.lang.String getJavaClass()
Gets the "java-class" property.

The fully-qualified name of the Java class that provides the Debug Log Publisher implementation.

Returns:
Returns the value of the "java-class" property.

setJavaClass

void setJavaClass(java.lang.String value)
                  throws IllegalPropertyValueException
Sets the "java-class" property.

The fully-qualified name of the Java class that provides the Debug Log Publisher implementation.

Parameters:
value - The value of the "java-class" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

listDebugTargets

java.lang.String[] listDebugTargets()
                                    throws ConcurrentModificationException,
                                           AuthorizationException,
                                           CommunicationException
Lists the Debug Targets.

Returns:
Returns an array containing the names of the Debug Targets.
Throws:
ConcurrentModificationException - If this Debug Log Publisher has been removed from the server by another client.
AuthorizationException - If the server refuses to list the Debug Targets because the client does not have the correct privileges.
CommunicationException - If the client cannot contact the server due to an underlying communication problem.

getDebugTarget

DebugTargetCfgClient getDebugTarget(java.lang.String name)
                                    throws DefinitionDecodingException,
                                           ManagedObjectDecodingException,
                                           ManagedObjectNotFoundException,
                                           ConcurrentModificationException,
                                           AuthorizationException,
                                           CommunicationException
Gets the named Debug Target.

Parameters:
name - The name of the Debug Target to retrieve.
Returns:
Returns the named Debug Target.
Throws:
DefinitionDecodingException - If the named Debug Target was found but its type could not be determined.
ManagedObjectDecodingException - If the named Debug Target was found but one or more of its properties could not be decoded.
ManagedObjectNotFoundException - If the named Debug Target was not found on the server.
ConcurrentModificationException - If this Debug Log Publisher has been removed from the server by another client.
AuthorizationException - If the server refuses to retrieve the named Debug Target because the client does not have the correct privileges.
CommunicationException - If the client cannot contact the server due to an underlying communication problem.

createDebugTarget

<C extends DebugTargetCfgClient> C createDebugTarget(ManagedObjectDefinition<C,? extends DebugTargetCfg> d,
                                                     java.lang.String name,
                                                     java.util.Collection<DefaultBehaviorException> exceptions)
                                                 throws IllegalManagedObjectNameException
Creates a new Debug Target. The new Debug Target will initially not contain any property values (including mandatory properties). Once the Debug Target has been configured it can be added to the server using the ConfigurationClient.commit() method.

Type Parameters:
C - The type of the Debug Target being created.
Parameters:
d - The definition of the Debug Target to be created.
name - The name of the new Debug Target.
exceptions - An optional collection in which to place any DefaultBehaviorExceptions that occurred whilst attempting to determine the default values of the Debug Target. This argument can be null.
Returns:
Returns a new Debug Target configuration instance.
Throws:
IllegalManagedObjectNameException - If the name of the new Debug Target is invalid.

removeDebugTarget

void removeDebugTarget(java.lang.String name)
                       throws ManagedObjectNotFoundException,
                              OperationRejectedException,
                              ConcurrentModificationException,
                              AuthorizationException,
                              CommunicationException
Removes the named Debug Target.

Parameters:
name - The name of the Debug Target to remove.
Throws:
ManagedObjectNotFoundException - If the Debug Target does not exist.
OperationRejectedException - If the server refuses to remove the Debug Target due to some server-side constraint which cannot be satisfied (for example, if it is referenced by another managed object).
ConcurrentModificationException - If this Debug Log Publisher has been removed from the server by another client.
AuthorizationException - If the server refuses to remove the Debug Target because the client does not have the correct privileges.
CommunicationException - If the client cannot contact the server due to an underlying communication problem.