com.bea.wlcp.wlng.tier_routing
Interface TierRoutingManagerMBean

public interface TierRoutingManagerMBean

Tier Routing Manager MBean.

Method Summary

abstract void	addTierRoute(java.lang.String endpointExpression, java.lang.String clusterName, int index) Adds a route which contains an endpoint expression and a cluster's name in a specific position in the route list.
abstract com.bea.wlcp.wlng.tier_routing.TierRouteDesc[]	listTierRoutes() Returns the list of route information.
abstract void	removeTierRoute(int index) Removes a tier route.

Method Detail

addTierRoute

public void addTierRoute(java.lang.String endpointExpression,
                         java.lang.String clusterName,
                         int index)
                  throws com.bea.wlcp.wlng.api.management.ManagementException

Adds a route which contains an endpoint expression and a cluster's name in a specific position in the route list.

Parameters:

endpointExpression - The pattern to be used as a matching criteria for the callback URL for network-triggered operations. Each Service Facade adds its own signature to the pattern. The following table shows examples of endpoint regular expressions:

Endpoint expressions	Description
.*realUrl=.*	Routes to a SOA Service Facade cluster, since the parameter realURL is present in the callback endpoint.
/bayeux.*	Routes to a RESTful Service Facade cluster, since the parameter bayeux is present in the callback endpoint.
http://.*mydomain.com/*	Routes to a specific cluster when the callback endpoint is within the domain mydomain.com. This makes it possible to inspect in which domain the callback endpoint is, and use one access cluster for a given set of service providers and another for another set of service providers. It makes it possible to use one Access tier cluster for applications residing in the network operator's intranet and another for applications hosted by service providers outside the network operator's domain.

Scope: Cluster

clusterName - The name of the cluster to pass the request to if the endpointExpression matches.

index - The position used to insert the route. The first matching route will be used so the order of the routes are important if a URL can match multiple routes. The new entry will shift any existing entries one index higher. To insert entry first in the list, use index 0 (zero). To insert an entry last in the list, use the number of list entries (the size of the list). If the value is less than 0 or greater than the max size of the route list, a ManagementException will be thrown.

Throws:

ManagementException.

com.bea.wlcp.wlng.api.management.ManagementException

listTierRoutes

public com.bea.wlcp.wlng.tier_routing.TierRouteDesc[] listTierRoutes()
                                                              throws com.bea.wlcp.wlng.api.management.ManagementException

Returns the list of route information. The list includes:

• index
• endpoint expression
• cluster name

Scope: Cluster

Throws:

com.bea.wlcp.wlng.api.management.ManagementException

removeTierRoute

public void removeTierRoute(int index)
                     throws com.bea.wlcp.wlng.api.management.ManagementException

Removes a tier route. The route is identified by the index. After the update, the index of all tier routes with a higher index than the removed are decreased by one.

Scope: Cluster

Parameters:

index - The route in the this specific position would be deleted. If the value is less than 0 or equal to or greater than the max size of the route list, a ManagementExeption will be thrown.

Throws:

com.bea.wlcp.wlng.api.management.ManagementException