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.runtime
Interface WebAppComponentRuntimeMBean

All Superinterfaces:
ComponentConcurrentRuntimeMBean, ComponentRuntimeMBean, DynamicMBean, MBeanRegistration, NotificationBroadcaster, RuntimeMBean, WebLogicMBean

public interface WebAppComponentRuntimeMBean
extends ComponentConcurrentRuntimeMBean

Describes a servlet component (servlet context).


Field Summary

 

Fields inherited from interface weblogic.management.runtime.ComponentRuntimeMBean
ACTIVATED, NEW, PREPARED, UNPREPARED

 

Method Summary
abstract  void deleteInvalidSessions()
          Invalidates expired sessions.
abstract  String getApplicationIdentifier()
          Provides the identifier of the application that contains the web module.
abstract  CoherenceClusterRuntimeMBean getCoherenceClusterRuntime()
          Returns the Coherence Cluster related runtime MBean for this component.
abstract  String getComponentName()
          Provides the name of this component.
abstract  String getConfiguredContextRoot()
           Returns the context root (context path) configured in weblogic-application.xml or web.xml file, or determined by name of the war file.
abstract  String getContextRoot()
          Returns the context root (context path) for the web application.
abstract  EJBRuntimeMBean getEJBRuntime(String ejbName)
          Provides the EJBRuntimeMBean for the EJB with the specified name.
abstract  EJBRuntimeMBean[] getEJBRuntimes()
          Provides an array of EJBRuntimeMBean objects for this module.
abstract  JaxRsApplicationRuntimeMBean[] getJaxRsApplications()
          Provides an array of JaxRsApplicationMBeans associated with this module.
abstract  String getJSPCompileCommand()
          Provides the JSP's compileCommand value as it is configured in weblogic.xml.
abstract  long getJSPPageCheckSecs()
          Provides the JSP's PageCheckSecs value as it is configured in weblogic.xml.
abstract  KodoPersistenceUnitRuntimeMBean getKodoPersistenceUnitRuntime(String unitName)
          Deprecated. As of 11.1.2.0, use getPersistenceUnitRuntime instead
abstract  KodoPersistenceUnitRuntimeMBean[] getKodoPersistenceUnitRuntimes()
          Deprecated. As of 11.1.2.0, use getPersistenceUnitRuntimes instead
abstract  LibraryRuntimeMBean[] getLibraryRuntimes()
          Returns the list of library runtime instances for each Java EE library that is contained in this enterprise application.
abstract  String getLogFilename()
          Returns the log filename as configured in the "logging/log-filename" element in weblogic.xml.
abstract  LogRuntimeMBean getLogRuntime()
          Returns the log runtime associated with the Java EE web application log.
abstract  String getModuleURI()
          Returns the web URI as configured in application.xml for the web application.
abstract  String getMonitoringId(String sessionId)
          Returns the monitoring ID for a session for a given session ID.
abstract  String getName()
          Provides the name of this MBean.
abstract  int getOpenSessionsCurrentCount()
          Provides a count of the current total number of open sessions in this module.
abstract  int getOpenSessionsHighCount()
          Provides the high water mark of the total number of open sessions in this server.
abstract  PageFlowsRuntimeMBean getPageFlows()
          Provides a hook for getting Beehive runtime metrics for the current module.
abstract  PersistenceUnitRuntimeMBean getPersistenceUnitRuntime(String unitName)
          Provides the PersistenceUnitRuntimeMBean for the web application with the specified name.
abstract  PersistenceUnitRuntimeMBean[] getPersistenceUnitRuntimes()
          Provides an array of PersistenceUnitRuntimeMBean objects for this web application module.
abstract  int getServletReloadCheckSecs()
          Provides the servlet reload check seconds as it is configured in weblogic.xml.
abstract  ServletRuntimeMBean[] getServlets()
          Provides an array of ServletRuntimeMBeans associated with this module.
abstract  ServletSessionRuntimeMBean getServletSession(String sessionID)
          Deprecated. as of WebLogic 9.0
abstract  ServletSessionRuntimeMBean[] getServletSessions()
          Deprecated. as of WebLogic 9.0, use getServletSessionsMonitoringTags()
abstract  String[] getServletSessionsMonitoringIds()
           This method returns an array of monitoring IDs for HTTP sessions.
abstract  String getSessionCookieComment()
          By default, all applications on WebLogic Server specify "WebLogic Session Tracking Cookie" as the cookie comment.
abstract  String getSessionCookieDomain()
          By default, clients can return cookies only to the server that issued the cookie.
abstract  int getSessionCookieMaxAgeSecs()
          Provides the life span of the session cookie, in seconds, after which it expires on the client.
abstract  String getSessionCookieName()
          By default, all applications on WebLogic Server specify "JSESSIONID" as the cookie name.
abstract  String getSessionCookiePath()
          Provides the path name to which clients send cookies.
abstract  int getSessionIDLength()
          Provides the session ID length configured for HTTP sessions.
abstract  int getSessionInvalidationIntervalSecs()
          Provides the invalidation check timer interval configured for HTTP sessions.
abstract  long getSessionLastAccessedTime(String monitoringId)
          Provides a record of the last time this session was accessed.
abstract  long getSessionMaxInactiveInterval(String monitoringId)
           Returns the timeout (seconds) for the session corresponding to the given monitoring ID.
abstract  int getSessionsOpenedTotalCount()
          Provides a count of the total number of sessions opened.
abstract  int getSessionTimeoutSecs()
          Provides the timeout configured for HTTP sessions.
abstract  int getSingleThreadedServletPoolSize()
          Provides the single threaded servlet pool size as it is configured in weblogic.xml.
abstract  String getSourceInfo()
          Provides an informative string about the module's source.
abstract  SpringRuntimeMBean getSpringRuntimeMBean()
           
abstract  String getStatus()
          Provides the status of the component.
abstract  WebPubSubRuntimeMBean getWebPubSubRuntime()
          Get HTTP pub-sub server runtime of this web application.
abstract  WebsocketApplicationRuntimeMBean getWebsocketApplicationRuntimeMBean()
          Provides a WebsocketApplicationRuntimeMBean associated with this module.
abstract  WseeClientConfigurationRuntimeMBean[] getWseeClientConfigurationRuntimes()
          Returns the list of Web Service client reference configuration runtime instances that are contained in this web application within an enterprise application.
abstract  WseeClientRuntimeMBean[] getWseeClientRuntimes()
          Returns the list of Web Service client runtime instances that are contained in this Enterprise JavaBean component.
abstract  WseeV2RuntimeMBean[] getWseeV2Runtimes()
          Returns the list of Web Service runtime instances that are contained in this web application within an enterprise application.
abstract  void invalidateServletSession(String monitoringId)
          Invalidates this session for a given monitoring ID.
abstract  boolean isFilterDispatchedRequestsEnabled()
          Indicates whether the dispatched requests are filtered as configured in weblogic.xml.
abstract  boolean isIndexDirectoryEnabled()
          Provides the directory indexing indicator as it is configured in weblogic.xml.
abstract  boolean isJSPDebug()
          Provides the JSP's debug/linenumbers parameter value as it is configured in weblogic.xml.
abstract  boolean isJSPKeepGenerated()
          Provides the JSP's KeepGenerated parameter value as it is configured in weblogic.xml.
abstract  boolean isJSPVerbose()
          Provides the JSP's verbose parameter value as it is configured in weblogic.xml.
abstract  boolean isSessionMonitoringEnabled()
          Provides the session monitoring indicator as it is configured in weblogic.xml.
abstract  JaxRsApplicationRuntimeMBean lookupJaxRsApplication(String name)
          Finds the JAX-RS application identified by name that is nothing but the corresponding servlet name.
abstract  WseeClientConfigurationRuntimeMBean lookupWseeClientConfigurationRuntime(String name)
          Returns a named Web Service client reference configuration runtime instance that is contained in this web application within an enterprise application.
abstract  WseeClientRuntimeMBean lookupWseeClientRuntime(String rawClientId)
          Returns a named Web Service client runtime instance that is contained in this Enterprise JavaBean component.
abstract  WseeV2RuntimeMBean lookupWseeV2Runtime(String name)
          Returns a named Web Service runtime instance that is contained in this web application within an enterprise application.

 

Methods inherited from interface weblogic.management.runtime.ComponentConcurrentRuntimeMBean
getManagedExecutorServiceRuntimes, getManagedScheduledExecutorServiceRuntimes, getManagedThreadFactoryRuntimes

 

Methods inherited from interface weblogic.management.runtime.ComponentRuntimeMBean
getDeploymentState, getModuleId, getWorkManagerRuntimes

 

Methods inherited from interface weblogic.management.runtime.RuntimeMBean
addPropertyChangeListener, removePropertyChangeListener

 

Methods inherited from interface weblogic.management.WebLogicMBean
getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setName, 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

 

Method Detail

getApplicationIdentifier

String getApplicationIdentifier()

Provides the identifier of the application that contains the web module.

Returns:
The application identifier.

getName

String getName()

Provides the name of this MBean.

Specified by:
getName in interface WebLogicMBean
Returns:
The name value

getComponentName

String getComponentName()

Provides the name of this component.

Returns:
The componentName value

getContextRoot

String getContextRoot()

Returns the context root (context path) for the web application.

Returns:
The contextRoot value

getConfiguredContextRoot

String getConfiguredContextRoot()

Returns the context root (context path) configured in weblogic-application.xml or web.xml file, or determined by name of the war file.

For web application deployed in partition scope, this configured context root does not include uriPrefix of the virtual target. The WebAppComponentRuntimeMBean.getContextRoot() method returns value which includes the uriPrefix of the virtual target.

For web application deployed in domain scope, this method returns same value as WebAppComponentRuntimeMBean.getContextRoot() method.

Returns:
The configured contextRoot value

getModuleURI

String getModuleURI()

Returns the web URI as configured in application.xml for the web application. For a standalone WAR, it will return the docroot (if exploded) or the name of the WAR file (if archived).

Returns:
the module URI for the web application

getStatus

String getStatus()

Provides the status of the component.

Returns:
The status value

getSourceInfo

String getSourceInfo()

Provides an informative string about the module's source.

Returns an informative string about the component's source.

Returns:
The sourceInfo value

getServlets

ServletRuntimeMBean[] getServlets()

Provides an array of ServletRuntimeMBeans associated with this module.

Returns an array of ServletRuntimeMBeans associated with this component.

Returns:
The servlet value

getEJBRuntimes

EJBRuntimeMBean[] getEJBRuntimes()

Provides an array of EJBRuntimeMBean objects for this module. The EJBRuntimeMBean instances can be cast to their appropriate subclass (EntityEJBRuntimeMBean, StatelessEJBRuntimeMBean, StatefulEJBRuntimeMBean or MessageDrivenEJBRuntimeMBean) to access additional runtime information for the particular EJB.

Returns:
The eJBRuntimes value

getEJBRuntime

EJBRuntimeMBean getEJBRuntime(String ejbName)

Provides the EJBRuntimeMBean for the EJB with the specified name.

Parameters:
ejbName -
Returns:
The eJBRuntime value

getJaxRsApplications

JaxRsApplicationRuntimeMBean[] getJaxRsApplications()

Provides an array of JaxRsApplicationMBeans associated with this module.

Returns:
The array of JAX-RS application MBeans

lookupJaxRsApplication

JaxRsApplicationRuntimeMBean lookupJaxRsApplication(String name)

Finds the JAX-RS application identified by name that is nothing but the corresponding servlet name.

Parameters:
name - the name of the runtime MBean
Returns:
the JAX-RS application when found or null

getWebsocketApplicationRuntimeMBean

WebsocketApplicationRuntimeMBean getWebsocketApplicationRuntimeMBean()

Provides a WebsocketApplicationRuntimeMBean associated with this module.

Returns:
WebSocket application runtime MBean

getOpenSessionsCurrentCount

int getOpenSessionsCurrentCount()

Provides a count of the current total number of open sessions in this module.

Returns the current total number of open sessions in this component.

Returns:
The openSessionsCurrentCount value

getOpenSessionsHighCount

int getOpenSessionsHighCount()

Provides the high water mark of the total number of open sessions in this server. The count starts at zero each time the server is activated. Note that this is an optimization method for a highly useful statistic that could be implemented less efficiently using change notification.

Returns:
The openSessionsHighCount value

getSessionsOpenedTotalCount

int getSessionsOpenedTotalCount()

Provides a count of the total number of sessions opened.

Returns:
The sessionsOpenedTotalCount value

getServletSessions

ServletSessionRuntimeMBean[] getServletSessions()
Deprecated. as of WebLogic 9.0, use getServletSessionsMonitoringTags()

Provides an array of ServletSessionRuntimeMBeans associated with this component. This operation should only be done by explicit poll request (no real-time monitoring). This method will return a non-empty array only when session-monitoring has been turned on in weblogic.xml.

Returns:
The servletSessions value
See Also:
WebAppComponentRuntimeMBean.getServletSessionsMonitoringIds()

getServletSession

ServletSessionRuntimeMBean getServletSession(String sessionID)
Deprecated. as of WebLogic 9.0

Provides the servlet session by its session ID.

Parameters:
sessionID -
Returns:
The servletSession value

getServletSessionsMonitoringIds

String[] getServletSessionsMonitoringIds()

This method returns an array of monitoring IDs for HTTP sessions. By default, the monitoring ID for a given HTTP session is a random string (not the same as session ID for security reasons). If the value of the element monitoring-attribute-name in session-descriptor of weblogic.xml is set, the monitoring ID will be the toString() of the attribute value in the session, using monitoring-attribute-name as the key.

Returns:
monitoring IDs for HTTP sessions

invalidateServletSession

void invalidateServletSession(String monitoringId)
                              throws IllegalStateException

Invalidates this session for a given monitoring ID.

Parameters:
monitoringId -
Throws:
IllegalStateException - if sessions has been invalidated already
See Also:
WebAppComponentRuntimeMBean.getServletSessionsMonitoringIds()

getSessionLastAccessedTime

long getSessionLastAccessedTime(String monitoringId)
                                throws IllegalStateException

Provides a record of the last time this session was accessed. You need to pass the string returned by getServletSessionsMonitoringIds().

Parameters:
monitoringId -
Returns:
The lastAccessedTime for a session
Throws:
IllegalStateException - if sessions has been invalidated already
See Also:
WebAppComponentRuntimeMBean.getServletSessionsMonitoringIds()

getSessionMaxInactiveInterval

long getSessionMaxInactiveInterval(String monitoringId)
                                   throws IllegalStateException

Returns the timeout (seconds) for the session corresponding to the given monitoring ID.

Parameters:
monitoringId -
Returns:
session's maxInactiveInterval
Throws:
IllegalStateException - if sessions have been invalidated already
See Also:
WebAppComponentRuntimeMBean.getServletSessionsMonitoringIds()

getMonitoringId

String getMonitoringId(String sessionId)

Returns the monitoring ID for a session for a given session ID.

Parameters:
sessionId -
Returns:
monitoring ID
Throws:
IllegalStateException - if sessions have been invalidated already

deleteInvalidSessions

void deleteInvalidSessions()

Invalidates expired sessions. This is useful for cleanup if the session invalidation trigger is too large.


getSessionTimeoutSecs

int getSessionTimeoutSecs()

Provides the timeout configured for HTTP sessions.

Returns:
The sessionTimeoutSecs value

getSessionInvalidationIntervalSecs

int getSessionInvalidationIntervalSecs()

Provides the invalidation check timer interval configured for HTTP sessions.

Returns:
The sessionInvalidationIntervalSecs value

getSessionIDLength

int getSessionIDLength()

Provides the session ID length configured for HTTP sessions.

Returns:
The sessionIDLength value

getSessionCookieComment

String getSessionCookieComment()

By default, all applications on WebLogic Server specify "WebLogic Session Tracking Cookie" as the cookie comment. To provide a more specific comment, edit your application's weblogic.xml deployment descriptor.

Returns:
The sessionCookieComment value

getSessionCookieDomain

String getSessionCookieDomain()

By default, clients can return cookies only to the server that issued the cookie. You can change this default behavior by editing your application's weblogic.xml deployment descriptor.

For more information, see the servlet specification.

Returns:
The sessionCookieDomain value

getSessionCookiePath

String getSessionCookiePath()

Provides the path name to which clients send cookies.

Returns:
The sessionCookiePath value

getSessionCookieName

String getSessionCookieName()

By default, all applications on WebLogic Server specify "JSESSIONID" as the cookie name. To provide a more specific name, edit your application's weblogic.xml deployment descriptor.

Returns:
The sessionCookieName value

getSessionCookieMaxAgeSecs

int getSessionCookieMaxAgeSecs()

Provides the life span of the session cookie, in seconds, after which it expires on the client. If the value is 0, the cookie expires immediately. If set to -1, the cookie expires when the user exits the browser.

Returns:
The sessionCookieMaxAgeSecs value

isFilterDispatchedRequestsEnabled

boolean isFilterDispatchedRequestsEnabled()

Indicates whether the dispatched requests are filtered as configured in weblogic.xml.

Returns:
The filterDispatchedRequestsEnabled value

isIndexDirectoryEnabled

boolean isIndexDirectoryEnabled()

Provides the directory indexing indicator as it is configured in weblogic.xml.

Returns:
The indexDirectoryEnabled value

getServletReloadCheckSecs

int getServletReloadCheckSecs()

Provides the servlet reload check seconds as it is configured in weblogic.xml.

Returns:
The servletReloadCheckSecs value

getSingleThreadedServletPoolSize

int getSingleThreadedServletPoolSize()

Provides the single threaded servlet pool size as it is configured in weblogic.xml.

Returns:
The singleThreadedServletPoolSize value

isSessionMonitoringEnabled

boolean isSessionMonitoringEnabled()

Provides the session monitoring indicator as it is configured in weblogic.xml.

Returns:
The sessionMonitoringEnabled value

isJSPKeepGenerated

boolean isJSPKeepGenerated()

Provides the JSP's KeepGenerated parameter value as it is configured in weblogic.xml.

Returns:
The jSPKeepGenerated value

isJSPVerbose

boolean isJSPVerbose()

Provides the JSP's verbose parameter value as it is configured in weblogic.xml.

Returns:
The jSPVerbose value

isJSPDebug

boolean isJSPDebug()

Provides the JSP's debug/linenumbers parameter value as it is configured in weblogic.xml.

Returns:
The jSPDebug value

getJSPPageCheckSecs

long getJSPPageCheckSecs()

Provides the JSP's PageCheckSecs value as it is configured in weblogic.xml.

Returns:
The jSPPageCheckSecs value

getJSPCompileCommand

String getJSPCompileCommand()

Provides the JSP's compileCommand value as it is configured in weblogic.xml.

Returns:
The jSPCompileCommand value

getLogFilename

String getLogFilename()
Returns the log filename as configured in the "logging/log-filename" element in weblogic.xml.
Returns:
The name of the log file. Null if not configured.

getLogRuntime

LogRuntimeMBean getLogRuntime()

Returns the log runtime associated with the Java EE web application log.

Returns:
LogRuntimeMBean associated with the web application log

getLibraryRuntimes

LibraryRuntimeMBean[] getLibraryRuntimes()

Returns the list of library runtime instances for each Java EE library that is contained in this enterprise application.

Returns:
LibraryRuntimeMBean Array, null if this application is not referencing any libraries.

getPageFlows

PageFlowsRuntimeMBean getPageFlows()

Provides a hook for getting Beehive runtime metrics for the current module.

Returns:
The Runtime MBean that surfaces Beehive runtime metrics

getSpringRuntimeMBean

SpringRuntimeMBean getSpringRuntimeMBean()

getKodoPersistenceUnitRuntimes

KodoPersistenceUnitRuntimeMBean[] getKodoPersistenceUnitRuntimes()
Deprecated. As of 11.1.2.0, use getPersistenceUnitRuntimes instead

Provides an array of KodoPersistenceUnitRuntimeMBean objects for this web application module.

Returns:
The persistenceUnitRuntimes value

getKodoPersistenceUnitRuntime

KodoPersistenceUnitRuntimeMBean getKodoPersistenceUnitRuntime(String unitName)
Deprecated. As of 11.1.2.0, use getPersistenceUnitRuntime instead

Provides the KodoPersistenceUnitRuntimeMBean for the web application with the specified name.

Parameters:
unitName -
Returns:
The persistenceUnitRuntime value

getPersistenceUnitRuntimes

PersistenceUnitRuntimeMBean[] getPersistenceUnitRuntimes()

Provides an array of PersistenceUnitRuntimeMBean objects for this web application module.

Returns:
The persistenceUnitRuntimes value

getPersistenceUnitRuntime

PersistenceUnitRuntimeMBean getPersistenceUnitRuntime(String unitName)

Provides the PersistenceUnitRuntimeMBean for the web application with the specified name.

Parameters:
unitName -
Returns:
The persistenceUnitRuntime value

getWebPubSubRuntime

WebPubSubRuntimeMBean getWebPubSubRuntime()
Get HTTP pub-sub server runtime of this web application.

getCoherenceClusterRuntime

CoherenceClusterRuntimeMBean getCoherenceClusterRuntime()

Returns the Coherence Cluster related runtime MBean for this component.

Returns:
CoherenceClusterRuntimeMBean
Since:
10.3.3.0

getWseeClientRuntimes

WseeClientRuntimeMBean[] getWseeClientRuntimes()

Returns the list of Web Service client runtime instances that are contained in this Enterprise JavaBean component.


lookupWseeClientRuntime

WseeClientRuntimeMBean lookupWseeClientRuntime(String rawClientId)

Returns a named Web Service client runtime instance that is contained in this Enterprise JavaBean component.

Parameters:
rawClientId - The raw client ID of the client to lookup. This ID does not contain the application/component qualifiers that are prepended to the full client ID for the client.
Returns:
The client runtime or null if no such client could be found.

getWseeV2Runtimes

WseeV2RuntimeMBean[] getWseeV2Runtimes()

Returns the list of Web Service runtime instances that are contained in this web application within an enterprise application.


lookupWseeV2Runtime

WseeV2RuntimeMBean lookupWseeV2Runtime(String name)

Returns a named Web Service runtime instance that is contained in this web application within an enterprise application.

Parameters:
name - The web service description name of the web service to look up.
Returns:
The web service runtime or null if no web service with the given name could be found.

getWseeClientConfigurationRuntimes

WseeClientConfigurationRuntimeMBean[] getWseeClientConfigurationRuntimes()

Returns the list of Web Service client reference configuration runtime instances that are contained in this web application within an enterprise application.


lookupWseeClientConfigurationRuntime

WseeClientConfigurationRuntimeMBean lookupWseeClientConfigurationRuntime(String name)

Returns a named Web Service client reference configuration runtime instance that is contained in this web application within an enterprise application.

Parameters:
name - The web service client reference name to look up.
Returns:
The web service client reference configuration runtime or null if no web service client reference configuration runtime with the given name could be found.

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