All Downloads are FREE. Search and download functionalities are using the official Maven repository.
Please wait. This can take some minutes ...
Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
flex.messaging.MessageDestination Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package flex.messaging;
import flex.management.runtime.messaging.MessageDestinationControl;
import flex.management.runtime.messaging.services.messaging.SubscriptionManagerControl;
import flex.management.runtime.messaging.services.messaging.ThrottleManagerControl;
import flex.messaging.config.ConfigurationConstants;
import flex.messaging.config.ConfigurationException;
import flex.messaging.config.DestinationSettings;
import flex.messaging.config.ThrottleSettings;
import flex.messaging.config.ConfigMap;
import flex.messaging.config.NetworkSettings;
import flex.messaging.config.ServerSettings;
import flex.messaging.config.ThrottleSettings.Policy;
import flex.messaging.log.LogCategories;
import flex.messaging.services.MessageService;
import flex.messaging.services.Service;
import flex.messaging.services.messaging.SubscriptionManager;
import flex.messaging.services.messaging.RemoteSubscriptionManager;
import flex.messaging.services.messaging.ThrottleManager;
import flex.messaging.services.messaging.MessagingConstants;
import flex.messaging.util.ClassUtil;
/**
* A logical reference to a MessageDestination.
*/
public class MessageDestination extends FactoryDestination
{
static final long serialVersionUID = -2016911808141319012L;
/** Log category for MessageDestination
.*/
public static final String LOG_CATEGORY = LogCategories.SERVICE_MESSAGE;
// Errors
private static final int UNSUPPORTED_POLICY = 10124;
// Destination properties
private transient ServerSettings serverSettings;
// Destination internal
private transient SubscriptionManager subscriptionManager;
private transient RemoteSubscriptionManager remoteSubscriptionManager;
private transient ThrottleManager throttleManager;
private transient MessageDestinationControl controller;
//--------------------------------------------------------------------------
//
// Constructor
//
//--------------------------------------------------------------------------
/**
* Constructs an unmanaged MessageDestination
instance.
*/
public MessageDestination()
{
this(false);
}
/**
* Constructs a MessageDestination
with the indicated management.
*
* @param enableManagement true
if the MessageDestination
* is manageable; otherwise false
.
*/
public MessageDestination(boolean enableManagement)
{
super(enableManagement);
serverSettings = new ServerSettings();
// Managers
subscriptionManager = new SubscriptionManager(this);
remoteSubscriptionManager = new RemoteSubscriptionManager(this);
}
//--------------------------------------------------------------------------
//
// Initialize, validate, start, and stop methods.
//
//--------------------------------------------------------------------------
/**
* Initializes the MessageDestination
with the properties.
* If subclasses override, they must call super.initialize()
.
*
* @param id The id of the destination.
* @param properties Properties for the MessageDestination
.
*/
@Override
public void initialize(String id, ConfigMap properties)
{
super.initialize(id, properties);
if (properties == null || properties.size() == 0)
return;
// Network properties
network(properties);
// Server properties
server(properties);
}
/**
* Sets up the throttle manager before it starts.
*/
@Override
public void start()
{
// Create the throttle manager, only if needed.
if (networkSettings.getThrottleSettings() != null)
{
ThrottleSettings settings = networkSettings.getThrottleSettings();
if (settings.isClientThrottleEnabled() || settings.isDestinationThrottleEnabled())
{
settings.setDestinationName(getId());
throttleManager = createThrottleManager();
throttleManager.setThrottleSettings(settings);
throttleManager.start();
}
}
super.start();
}
/**
* Stops the subscription, remote subscription, and throttle managers and
* then calls super class's stop.
*/
@Override
public void stop()
{
if (isStarted())
{
subscriptionManager.stop();
remoteSubscriptionManager.stop();
if (throttleManager != null)
throttleManager.stop();
}
super.stop();
}
//--------------------------------------------------------------------------
//
// Public Getters and Setters for Destination properties
//
//--------------------------------------------------------------------------
/**
* Sets the NetworkSettings
of the MessageDestination
.
*
* @param networkSettings The NetworkSettings
of the MessageDestination
*/
@Override
public void setNetworkSettings(NetworkSettings networkSettings)
{
super.setNetworkSettings(networkSettings);
// Set the subscription manager settings if needed.
if (networkSettings.getSubscriptionTimeoutMinutes() > 0)
{
long subscriptionTimeoutMillis = networkSettings.getSubscriptionTimeoutMinutes() * 60L * 1000L; // Convert to millis.
subscriptionManager.setSubscriptionTimeoutMillis(subscriptionTimeoutMillis);
}
}
/**
* Returns the ServerSettings
of the MessageDestination
.
*
* @return The ServerSettings
of the MessageDestination
.
*/
public ServerSettings getServerSettings()
{
return serverSettings;
}
/**
* Sets the ServerSettings
of the MessageDestination
.
*
* @param serverSettings The ServerSettings
of the MessageDestination
*/
public void setServerSettings(ServerSettings serverSettings)
{
this.serverSettings = serverSettings;
}
/**
* Casts the Service
into MessageService
* and calls super.setService.
*
* @param service The Service
managing this Destination
.
*/
@Override
public void setService(Service service)
{
MessageService messageService = (MessageService)service;
super.setService(messageService);
}
//--------------------------------------------------------------------------
//
// Other Public Methods
//
//--------------------------------------------------------------------------
/**
*
* Returns a ConfigMap of destination properties that the client
* needs. This includes properties from super{@link #describeDestination(boolean)}
* and it also includes outbound throttling policy that the edge server might need.
*
* @param onlyReliable Determines whether only reliable destination configuration should be returned.
* @return A ConfigMap of destination properties that the client needs.
*/
@Override
public ConfigMap describeDestination(boolean onlyReliable)
{
ConfigMap destinationConfig = super.describeDestination(onlyReliable);
if (destinationConfig == null)
return null;
if (throttleManager == null)
return destinationConfig;
Policy outboundPolicy = throttleManager.getOutboundPolicy();
if (outboundPolicy == null || outboundPolicy == Policy.NONE)
return destinationConfig;
// Add the outbound throttle policy to network properties section as appropriate.
ConfigMap properties = destinationConfig.getPropertyAsMap(ConfigurationConstants.PROPERTIES_ELEMENT, null);
if (properties == null)
{
properties = new ConfigMap();
destinationConfig.addProperty(ConfigurationConstants.PROPERTIES_ELEMENT, properties);
}
ConfigMap network = properties.getPropertyAsMap(NetworkSettings.NETWORK_ELEMENT, null);
if (network == null)
{
network = new ConfigMap();
properties.addProperty(NetworkSettings.NETWORK_ELEMENT, network);
}
ConfigMap throttleOutbound = new ConfigMap();
throttleOutbound.addProperty(ThrottleSettings.ELEMENT_POLICY, throttleManager.getOutboundPolicy().toString());
network.addProperty(ThrottleSettings.ELEMENT_OUTBOUND, throttleOutbound);
return destinationConfig;
}
public SubscriptionManager getSubscriptionManager()
{
return subscriptionManager;
}
public RemoteSubscriptionManager getRemoteSubscriptionManager()
{
return remoteSubscriptionManager;
}
public ThrottleManager getThrottleManager()
{
return throttleManager;
}
@Override
public boolean equals(Object o)
{
if (o instanceof Destination)
{
Destination d = (Destination)o;
String serviceType1 = d.getServiceType();
String serviceType2 = getServiceType();
if ((serviceType1 == null && serviceType2 == null) || (serviceType1 != null && serviceType1.equals(serviceType2)))
{
String id1 = d.getId();
String id2 = getId();
if ((id1 == null && id2 == null) || (id1 != null && id1.equals(id2)))
return true;
}
}
return false;
}
@Override
public int hashCode()
{
return (getServiceType() == null ? 0 : getServiceType().hashCode()) * 100003 +
(getId() == null ? 0 : getId().hashCode());
}
@Override
public String toString()
{
return getServiceType() + "#" + getId();
}
//--------------------------------------------------------------------------
//
// Protected/Private Methods
//
//--------------------------------------------------------------------------
protected ThrottleManager createThrottleManager()
{
Service service = getService();
if (service == null || service.getMessageBroker() == null)
return new ThrottleManager(); // Return the default.
try
{
Class extends ThrottleManager> throttleManagerClass = service.getMessageBroker().getThrottleManagerClass();
Object instance = ClassUtil.createDefaultInstance(throttleManagerClass, null);
if (instance instanceof ThrottleManager)
return (ThrottleManager)instance;
}
catch (Throwable t)
{
// NOWARN
}
return new ThrottleManager(); // Return the default.
}
protected void network(ConfigMap properties)
{
ConfigMap network = properties.getPropertyAsMap(NetworkSettings.NETWORK_ELEMENT, null);
if (network == null)
return;
// Get implementation specific network settings, including subclasses!
NetworkSettings ns = getNetworkSettings();
// Subscriber timeout; first check for subscription-timeout-minutes and fallback to legacy session-timeout.
int useLegacyPropertyToken = -999999;
int subscriptionTimeoutMinutes = network.getPropertyAsInt(NetworkSettings.SUBSCRIPTION_TIMEOUT_MINUTES, useLegacyPropertyToken);
if (subscriptionTimeoutMinutes == useLegacyPropertyToken)
subscriptionTimeoutMinutes = network.getPropertyAsInt(NetworkSettings.SESSION_TIMEOUT, NetworkSettings.DEFAULT_TIMEOUT);
ns.setSubscriptionTimeoutMinutes(subscriptionTimeoutMinutes);
// Throttle Settings
ThrottleSettings ts = ns.getThrottleSettings();
ts.setDestinationName(getId());
throttle(ts, network);
setNetworkSettings(ns);
}
protected void throttle(ThrottleSettings ts, ConfigMap network)
{
ConfigMap inbound = network.getPropertyAsMap(ThrottleSettings.ELEMENT_INBOUND, null);
if (inbound != null)
{
ThrottleSettings.Policy policy = getPolicyFromThrottleSettings(inbound);
ts.setInboundPolicy(policy);
int destFreq = inbound.getPropertyAsInt(ThrottleSettings.ELEMENT_DEST_FREQ, 0);
ts.setIncomingDestinationFrequency(destFreq);
int clientFreq = inbound.getPropertyAsInt(ThrottleSettings.ELEMENT_CLIENT_FREQ, 0);
ts.setIncomingClientFrequency(clientFreq);
}
ConfigMap outbound = network.getPropertyAsMap(ThrottleSettings.ELEMENT_OUTBOUND, null);
if (outbound != null)
{
ThrottleSettings.Policy policy = getPolicyFromThrottleSettings(outbound);
ts.setOutboundPolicy(policy);
int destFreq = outbound.getPropertyAsInt(ThrottleSettings.ELEMENT_DEST_FREQ, 0);
ts.setOutgoingDestinationFrequency(destFreq);
int clientFreq = outbound.getPropertyAsInt(ThrottleSettings.ELEMENT_CLIENT_FREQ, 0);
ts.setOutgoingClientFrequency(clientFreq);
}
}
private ThrottleSettings.Policy getPolicyFromThrottleSettings(ConfigMap settings)
{
String policyString = settings.getPropertyAsString(ThrottleSettings.ELEMENT_POLICY, null);
ThrottleSettings.Policy policy = ThrottleSettings.Policy.NONE;
if (policyString == null)
return policy;
try
{
policy = ThrottleSettings.parsePolicy(policyString);
}
catch (ConfigurationException exception)
{
ConfigurationException ce = new ConfigurationException();
ce.setMessage(UNSUPPORTED_POLICY, new Object[] {getId(), policyString});
throw ce;
}
return policy;
}
protected void server(ConfigMap properties)
{
ConfigMap server = properties.getPropertyAsMap(DestinationSettings.SERVER_ELEMENT, null);
if (server == null)
return;
long ttl = server.getPropertyAsLong(MessagingConstants.TIME_TO_LIVE_ELEMENT, -1);
serverSettings.setMessageTTL(ttl);
boolean durable = server.getPropertyAsBoolean(MessagingConstants.IS_DURABLE_ELEMENT, false);
serverSettings.setDurable(durable);
boolean allowSubtopics = server.getPropertyAsBoolean(MessagingConstants.ALLOW_SUBTOPICS_ELEMENT, false);
serverSettings.setAllowSubtopics(allowSubtopics);
boolean disallowWildcardSubtopics = server.getPropertyAsBoolean(MessagingConstants.DISALLOW_WILDCARD_SUBTOPICS_ELEMENT, false);
serverSettings.setDisallowWildcardSubtopics(disallowWildcardSubtopics);
int priority = server.getPropertyAsInt(MessagingConstants.MESSAGE_PRIORITY, -1);
if (priority != -1)
serverSettings.setPriority(priority);
String subtopicSeparator = server.getPropertyAsString(MessagingConstants.SUBTOPIC_SEPARATOR_ELEMENT, MessagingConstants.DEFAULT_SUBTOPIC_SEPARATOR);
serverSettings.setSubtopicSeparator(subtopicSeparator);
String routingMode = server.getPropertyAsString(MessagingConstants.CLUSTER_MESSAGE_ROUTING, "server-to-server");
serverSettings.setBroadcastRoutingMode(routingMode);
}
/**
* Returns the log category of the MessageDestination
.
*
* @return The log category of the component.
*/
@Override
protected String getLogCategory()
{
return LOG_CATEGORY;
}
/**
* Invoked automatically to allow the MessageDestination
to setup its corresponding
* MBean control.
*
* @param service The Service
that manages this MessageDestination
.
*/
@Override
protected void setupDestinationControl(Service service)
{
controller = new MessageDestinationControl(this, service.getControl());
controller.register();
setControl(controller);
setupThrottleManagerControl(controller);
setupSubscriptionManagerControl(controller);
}
protected void setupThrottleManagerControl(MessageDestinationControl destinationControl)
{
if (throttleManager != null)
{
ThrottleManagerControl throttleManagerControl = new ThrottleManagerControl(throttleManager, destinationControl);
throttleManagerControl.register();
throttleManager.setControl(throttleManagerControl);
throttleManager.setManaged(true);
destinationControl.setThrottleManager(throttleManagerControl.getObjectName());
}
}
private void setupSubscriptionManagerControl(MessageDestinationControl destinationControl)
{
SubscriptionManagerControl subscriptionManagerControl = new SubscriptionManagerControl(getSubscriptionManager(), destinationControl);
subscriptionManagerControl.register();
getSubscriptionManager().setControl(subscriptionManagerControl);
getSubscriptionManager().setManaged(true);
destinationControl.setSubscriptionManager(subscriptionManagerControl.getObjectName());
}
}