ListerMBean (Abstract)


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

The ListerMBean interface provides a general mechanism for returning lists.

Derived MBeans extend this interface to add methods that access the data of the current object in the list. This is different from the iterator model (where the next method returns the next object in the list) because creating MBeans for each object returned in a list (for example, one MBean per user) is too expensive. In addition, it is not appropriate to return non-MBean or non-primitive types from an MBean.

The general iteration pattern is as follows:

FooListerMBean fooLister = ...;
String cursor = lister.listFoo(...);
try {
while (fooLister.haveCurrent(cursor)) {
Foo currentVal = fooLister.getCurrentFoo(cursor);
fooLister.advance(cursor);
}
} finally {
fooLister.close(cursor);

       
Fully Qualified Interface NameIf you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.management.utils.ListerMBean
Factory Methods No factory methods. Instances of this MBean are created automatically.
Subtypes The following MBeans extend or implement this MBean type:


Operations

This section describes the following operations:


advance

Advances the list to the next element in the list.

   
Operation Name"advance"
ParametersObject [] {  cursor }

where:

  • cursor is an object of type java.lang.String that specifies:

    - The cursor returned from a previous list method.

SignatureString [] { "java.lang.String" }
Returns void
Exceptions
  • weblogic.management.utils.InvalidCursorException

close

Indicates that the caller is finished using the list, and that the resources held on behalf of the list may be released. If the caller traverses through all the elements in the list, the caller need not call this method. In other words, it is used to let the caller close the list without reading each element that is returned.

   
Operation Name"close"
ParametersObject [] {  cursor }

where:

  • cursor is an object of type java.lang.String that specifies:

    - The cursor returned from a previous list method.

SignatureString [] { "java.lang.String" }
Returns void
Exceptions
  • weblogic.management.utils.InvalidCursorException

haveCurrent

Returns true if there are more objects in the list, and false otherwise.

   
Operation Name"haveCurrent"
ParametersObject [] {  cursor }

where:

  • cursor is an object of type java.lang.String that specifies:

    - The cursor returned from a previous list method.

SignatureString [] { "java.lang.String" }
Returns boolean
Exceptions
  • weblogic.management.utils.InvalidCursorException

isSet

Returns true if the specified attribute has been set explicitly in this MBean instance.

   
Operation Name"isSet"
ParametersObject [] {  propertyName }

where:

  • propertyName is an object of type java.lang.String that specifies:

    property to check

SignatureString [] { "java.lang.String" }
Returns boolean
Exceptions
  • java.lang.IllegalArgumentException

unSet

Restore the given property to its default value.

   
Operation Name"unSet"
ParametersObject [] {  propertyName }

where:

  • propertyName is an object of type java.lang.String that specifies:

    property to restore

SignatureString [] { "java.lang.String" }
Returns void
Exceptions
  • java.lang.IllegalArgumentException
    UnsupportedOperationException if called on a runtime implementation.

wls_getDisplayName

Returns the display name of an MBean.

Deprecated 9.0.0.0

   
Operation Name"wls_getDisplayName"
Parametersnull
Signaturenull
ReturnsString