Skip navigation links

Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.2.1)

Part Number E55141-01
P4 Change 1723563 on 2015/10/09


weblogic.management.configuration
Interface SingletonServiceMBean

All Superinterfaces:
ConfigurationMBean, DescriptorBean, DynamicMBean, MBeanRegistration, NotificationBroadcaster, SettableBean, SingletonServiceBaseMBean, WebLogicMBean

public interface SingletonServiceMBean
extends SingletonServiceBaseMBean

A service that will be automatically maintained as a Singleton in a cluster. There will always be exactly one instance of it active at any given time.

Since:
9.0.2.0
See Also:
SingletonServiceBaseMBean

Field Summary

 

Fields inherited from interface weblogic.management.configuration.ConfigurationMBean
DEFAULT_EMPTY_BYTE_ARRAY

 

Method Summary
abstract  boolean addConstrainedCandidateServer(ServerMBean constrainedCandidateServer)
           
abstract  ServerMBean[] getAllCandidateServers()
          Return a list of servers that are candidates to host the services deployed to this migratable target.
abstract  String getClassName()
          The fully qualified name of a class to load and run.
abstract  ClusterMBean getCluster()
          Returns the cluster this singleton service is associated with.
abstract  ServerMBean[] getConstrainedCandidateServers()
          Returns the (user restricted) list of servers that may host the migratable target.
abstract  boolean removeConstrainedCandidateServer(ServerMBean constrainedCandidateServer)
           
abstract  void setAllCandidateServers(ServerMBean[] servers)
           NOT TO BE USED FROM THE OUTSIDE.
abstract  void setClassName(String className)
          Sets the value of the className attribute.
abstract  void setCluster(ClusterMBean cluster)
          Set the cluster this singleton service is associated with.
abstract  void setConstrainedCandidateServers(ServerMBean[] constrainedCandidateServers)
          All constrained candiate servers must belong to the same cluster.

 

Methods inherited from interface weblogic.management.configuration.SingletonServiceBaseMBean
getAdditionalMigrationAttempts, getHostingServer, getMillisToSleepBetweenAttempts, getUserPreferredServer, setAdditionalMigrationAttempts, setMillisToSleepBetweenAttempts, setUserPreferredServer

 

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
freezeCurrentValue, getId, getInheritedProperties, getName, getNotes, isDynamicallyCreated, isInherited, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet

 

Methods inherited from interface weblogic.management.WebLogicMBean
getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent

 

Methods inherited from interface javax.management.DynamicMBean
getAttribute, getAttributes, invoke, setAttribute, setAttributes

 

Methods inherited from interface javax.management.MBeanRegistration
postDeregister, postRegister, preDeregister, preRegister

 

Methods inherited from interface javax.management.NotificationBroadcaster
addNotificationListener, getNotificationInfo, removeNotificationListener

 

Methods inherited from interface weblogic.descriptor.DescriptorBean
addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener

 

Method Detail

getClassName

String getClassName()

The fully qualified name of a class to load and run. The class must be on the server's classpath.

For example, mycompany.mypackage.myclass

Returns:
The className value

setClassName

void setClassName(String className)
                  throws InvalidAttributeValueException

Sets the value of the className attribute.

Parameters:
className - The new className value
Throws:
InvalidAttributeValueException
See Also:
SingletonServiceMBean.getClassName()

getConstrainedCandidateServers

ServerMBean[] getConstrainedCandidateServers()

Returns the (user restricted) list of servers that may host the migratable target. The target will not be allowed to migrate to a server that is not in the returned list of servers. This feature is used to e.g. configure the two server that have access to a dual ported disk. All servers in this list must be part of the cluster that is associated with the migratable target.

Returns:
The constrainedCandidateServers value

setConstrainedCandidateServers

void setConstrainedCandidateServers(ServerMBean[] constrainedCandidateServers)
                                    throws InvalidAttributeValueException

All constrained candiate servers must belong to the same cluster.

Parameters:
constrainedCandidateServers - The new constrainedCandidateServers value
Throws:
InvalidAttributeValueException

addConstrainedCandidateServer

boolean addConstrainedCandidateServer(ServerMBean constrainedCandidateServer)
                                      throws InvalidAttributeValueException
Parameters:
constrainedCandidateServer - The server to be added as a constrained candidate
Throws:
InvalidAttributeValueException

removeConstrainedCandidateServer

boolean removeConstrainedCandidateServer(ServerMBean constrainedCandidateServer)
                                         throws InvalidAttributeValueException
Parameters:
constrainedCandidateServer -
Throws:
InvalidAttributeValueException

getCluster

ClusterMBean getCluster()

Returns the cluster this singleton service is associated with.

Returns:
The cluster value

setCluster

void setCluster(ClusterMBean cluster)

Set the cluster this singleton service is associated with.

Parameters:
cluster - The new cluster value

getAllCandidateServers

ServerMBean[] getAllCandidateServers()

Return a list of servers that are candidates to host the services deployed to this migratable target. If the ConstrainedCandidateServer list is empty, all servers in the cluster are returned. If the ConstrainedCandidateServer is not empty those servers only will be returned. The user preferred server will be the first element in the list returned.

Returns:
The allCandidateServers value

setAllCandidateServers

void setAllCandidateServers(ServerMBean[] servers)

NOT TO BE USED FROM THE OUTSIDE. MUST BE HERE ONLY TO SATISFY THE MBEAN SERVER. AllCandidateServers IS A DERIVED ATTRIBUTE AND THUS MUST NOT BE SET.

Parameters:
servers - The new allCandidateServers value

Skip navigation links

Copyright 1996, 2015, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.2.1)

Part Number E55141-01
P4 Change 1723563 on 2015/10/09