Class ManagementInvocationPolicy

java.lang.Object
com.tangosol.net.management.ManagementInvocationPolicy
public final class ManagementInvocationPolicy extends Object
Central policy for management TCMP invocation requests that can reach a local MBeanServer.
Since:
26.04
Author:
as 2026.05.14

  • Method Details

    • validateRemoteFunction

      public static void validateRemoteFunction(Remote.Function function, Subject subject, String sScope)
      Validate an MBeanServerProxy.execute(Remote.Function) function.
      Parameters:
      function - the function to validate
      subject - the current subject, or null
      sScope - the caller scope

    • validateObjectName

      public static ObjectName validateObjectName(String sName, String sDomain, String sScope)
      Validate a concrete management ObjectName string.
      Parameters:
      sName - the management name
      sDomain - the local management domain
      sScope - the caller scope
      Returns:
      the normalized object name

    • validateQueryPattern

      public static ObjectName validateQueryPattern(String sPattern, String sDomain, String sScope)
      Validate a management query pattern.
      Parameters:
      sPattern - the management query pattern
      sDomain - the local management domain
      sScope - the caller scope
      Returns:
      the normalized query pattern

    • validateQueryPattern

      public static ObjectName validateQueryPattern(ObjectName name, String sScope)
      Validate a management query pattern.
      Parameters:
      name - the management query pattern
      sScope - the caller scope
      Returns:
      the normalized query pattern

    • validateObjectName

      public static ObjectName validateObjectName(ObjectName name, String sScope)
      Validate a matched ObjectName before using it as an MBeanServer target.
      Parameters:
      name - the matched ObjectName
      sScope - the caller scope
      Returns:
      the validated ObjectName

    • validateQueryResult

      public static void validateQueryResult(Set<?> setNames, String sScope)
      Validate a set of ObjectNames returned by a query.
      Parameters:
      setNames - the returned names
      sScope - the caller scope

    • validateReadQueryResult

      public static void validateReadQueryResult(Set<?> setNames, String sScope)
      Validate a set of ObjectNames returned by a read-only query.
      Parameters:
      setNames - the returned names
      sScope - the caller scope

    • validateGetAttribute

      public static void validateGetAttribute(MBeanServer server, ObjectName name, String sAttr, String sScope)
      Validate an attribute read.
      Parameters:
      server - the MBeanServer
      name - the ObjectName
      sAttr - the attribute name
      sScope - the caller scope

    • validateSetAttribute

      public static void validateSetAttribute(MBeanServer server, ObjectName name, Attribute attr, String sScope)
      Validate an attribute write.
      Parameters:
      server - the MBeanServer
      name - the ObjectName
      attr - the attribute
      sScope - the caller scope

    • validateInvoke

      public static void validateInvoke(MBeanServer server, ObjectName name, String sOperation, Object[] aoParam, String[] asSignature, String sScope)
      Validate an MBean operation invocation.
      Parameters:
      server - the MBeanServer
      name - the ObjectName
      sOperation - the operation name
      aoParam - the parameters
      asSignature - the signature
      sScope - the caller scope

    • validateWrapperInvoke

      public static void validateWrapperInvoke(MBeanServer server, ObjectName name, String sOperation, Object[] aoParam, String[] asSignature)
      Validate a WrapperJmxModel operation invocation.
      Parameters:
      server - the MBeanServer
      name - the ObjectName
      sOperation - the operation name
      aoParam - the parameters
      asSignature - the signature

    • validateArguments

      public static void validateArguments(Object[] aoParam, String[] asSignature, String sScope)
      Validate parameters and signature values.
      Parameters:
      aoParam - the parameters
      asSignature - the signature
      sScope - the caller scope

    • validateSafeManagementValue

      public static void validateSafeManagementValue(Object oValue, String sScope, String sGate)
      Validate a single management value.
      Parameters:
      oValue - the value
      sScope - the caller scope
      sGate - the gate name

    • validateRemoteModelInvocation

      public static void validateRemoteModelInvocation(MBeanInfo info, int nOp, String sMethod, Object[] aoParam, String[] asSignature, String sScope)
      Validate a RemoteModel operation against its exposed MBean descriptor.
      Parameters:
      info - the exposed MBean descriptor
      nOp - the RemoteModel operation id
      sMethod - the reflected method name
      aoParam - the invocation parameters
      asSignature - the invocation signature
      sScope - the caller scope

    • validateRemoteModelInvocation

      public static void validateRemoteModelInvocation(MBeanInfo info, Class<?> clzModel, int nOp, String sMethod, Object[] aoParam, String[] asSignature, String sScope)
      Validate a RemoteModel operation against its exposed MBean descriptor.
      Parameters:
      info - the exposed MBean descriptor
      clzModel - the reflected local model class, or null
      nOp - the RemoteModel operation id
      sMethod - the reflected method name
      aoParam - the invocation parameters
      asSignature - the invocation signature
      sScope - the caller scope

    • validateParsedQuery

      public static void validateParsedQuery(MBeanAccessor.QueryBuilder.ParsedQuery query, String sScope)
      Validate an MBeanAccessor query before it reaches a server-side query.
      Parameters:
      query - the query
      sScope - the caller scope

    • validateAttributeFilter

      public static void validateAttributeFilter(Filter<?> filter, String sScope)
      Validate an attribute filter before it can evaluate MBean metadata.
      Parameters:
      filter - the attribute filter
      sScope - the caller scope

    • validateQueryFilter

      public static void validateQueryFilter(Filter filter, String sScope)
      Validate a direct management query filter.
      Parameters:
      filter - the filter
      sScope - the caller scope

    • validateCollectorFunction

      public static void validateCollectorFunction(com.tangosol.internal.net.management.MBeanCollectorFunction function, String sScope)
      Validate an MBeanCollectorFunction before it reaches a server-side query.
      Parameters:
      function - the function
      sScope - the caller scope

    • reject

      public static void reject(String sScope, String sGate, String sReason, String sValue, Subject subject)
      Reject a management TCMP request.
      Parameters:
      sScope - the caller scope
      sGate - the gate name
      sReason - the rejection reason
      sValue - a bounded value
      subject - the current subject, or null