/*
* Hibernate, Relational Persistence for Idiomatic Java
*
* Copyright (c) 2012, Red Hat, Inc. and/or its affiliates or third-party contributors as
* indicated by the @author tags or express copyright attribution
* statements applied by the authors. All third-party contributions are
* distributed under license by Red Hat, Inc.
*
* This copyrighted material is made available to anyone wishing to use, modify,
* copy, or redistribute it subject to the terms and conditions of the GNU
* Lesser General Public License, as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this distribution; if not, write to:
* Free Software Foundation, Inc.
* 51 Franklin Street, Fifth Floor
* Boston, MA 02110-1301 USA
*/
package org.hibernate.search.backend.impl.jgroups;
import java.net.URL;
import java.util.Properties;
import org.hibernate.search.engine.ServiceManager;
import org.hibernate.search.spi.BuildContext;
import org.hibernate.search.spi.ServiceProvider;
import org.hibernate.search.util.configuration.impl.ConfigurationParseHelper;
import org.hibernate.search.util.logging.impl.Log;
import org.hibernate.search.util.logging.impl.LoggerFactory;
import org.jgroups.Channel;
import org.jgroups.JChannel;
import org.jgroups.MessageListener;
import org.jgroups.UpHandler;
import org.jgroups.blocks.MessageDispatcher;
import org.jgroups.blocks.mux.MuxMessageDispatcher;
import org.jgroups.blocks.mux.Muxer;
/**
* Service to initialize a JGroups Channel. This needs to be centralized to
* allow sharing of channels across different index managers.
*
* @author Lukasz Moren
* @author Sanne Grinovero <sanne@hibernate.org> (C) 2012 Red Hat Inc.
* @author Ales Justin
*/
public class JGroupsChannelProvider implements ServiceProvider<MessageSender> {
private static final Log log = LoggerFactory.make();
public static final String JGROUPS_PREFIX = "hibernate.search.services.jgroups.";
public static final String CONFIGURATION_FILE = JGROUPS_PREFIX + "configurationFile";
public static final String CLUSTER_NAME = JGROUPS_PREFIX + "clusterName";
public static final String CHANNEL_INJECT = JGROUPS_PREFIX + "providedChannel";
public static final String CLASSLOADER = JGROUPS_PREFIX + "classloader";
public static final String MUX_ID = JGROUPS_PREFIX + "mux_id";
private static final String DEFAULT_JGROUPS_CONFIGURATION_FILE = "flush-udp.xml";
private static final String DEFAULT_CLUSTER_NAME = "Hibernate Search Cluster";
private Channel channel;
private MessageSender sender;
private ServiceManager serviceManager;
@Override
public void start(Properties props, BuildContext context) {
serviceManager = context.getServiceManager();
log.jGroupsStartingChannel();
boolean channelIsManaged = buildChannel( props );
String clusterName = props.getProperty( JGroupsChannelProvider.CLUSTER_NAME, DEFAULT_CLUSTER_NAME );
NodeSelectorStrategyHolder masterNodeSelector = serviceManager.requestService( MasterSelectorServiceProvider.class, context );
JGroupsMasterMessageListener listener = new JGroupsMasterMessageListener( context, masterNodeSelector );
UpHandler handler = channel.getUpHandler();
if ( handler instanceof Muxer ) {
Short muxId = (Short) props.get( MUX_ID );
if ( muxId == null ) {
throw log.missingJGroupsMuxId();
}
@SuppressWarnings("unchecked")
Muxer<UpHandler> muxer = (Muxer<UpHandler>) handler;
if ( muxer.get( muxId ) != null ) {
throw log.jGroupsMuxIdAlreadyTaken( muxId );
}
ClassLoader cl = (ClassLoader) props.get( CLASSLOADER );
MessageListener wrapper = ( cl != null ) ? new ClassloaderMessageListener( listener, cl ) : listener;
MessageListenerToRequestHandlerAdapter adapter = new MessageListenerToRequestHandlerAdapter( wrapper );
MessageDispatcher dispatcher = new MuxMessageDispatcher( muxId, channel, wrapper, listener, adapter );
sender = new DispatcherMessageSender( dispatcher );
}
else {
// TODO -- perhaps port previous multi-handling?
channel.setReceiver( listener );
sender = new ChannelMessageSender( channel, channelIsManaged, clusterName);
}
sender.start();
masterNodeSelector.setLocalAddress( channel.getAddress() );
log.jGroupsConnectedToCluster( clusterName, channel.getAddress() );
if ( !channel.flushSupported() ) {
log.jGroupsFlushNotPresentInStack();
}
}
@Override
public MessageSender getService() {
return sender;
}
@Override
public void stop() {
serviceManager.releaseService( MasterSelectorServiceProvider.class );
serviceManager = null;
try {
channel = null;
if ( sender != null ) {
sender.stop();
sender = null;
}
}
catch ( Exception toLog ) {
log.jGroupsClosingChannelError( toLog );
}
}
/**
* Reads configuration and builds channel with its base.
* In order of preference - we first look for an external JGroups file, then a set of XML properties, and
* finally the legacy JGroups String properties.
*
* @param props configuration file
* @return true if channel is managed, false otherwise
*/
private boolean buildChannel(Properties props) {
boolean channelIsManaged = true;
if ( props != null ) {
if ( props.containsKey( JGroupsChannelProvider.CHANNEL_INJECT ) ) {
Object channelObject = props.get( JGroupsChannelProvider.CHANNEL_INJECT );
try {
channel = (org.jgroups.JChannel) channelObject;
channelIsManaged = false;
}
catch ( ClassCastException e ) {
throw log.jGroupsChannelInjectionError( e, channelObject.getClass() );
}
}
if ( props.containsKey( JGroupsChannelProvider.CONFIGURATION_FILE ) ) {
String cfg = props.getProperty( JGroupsChannelProvider.CONFIGURATION_FILE );
try {
channel = new JChannel( ConfigurationParseHelper.locateConfig( cfg ) );
}
catch ( Exception e ) {
throw log.jGroupsChannelCreationUsingFileError( cfg, e );
}
}
}
if ( channel == null ) {
log.jGroupsConfigurationNotFoundInProperties( props );
try {
URL fileUrl = ConfigurationParseHelper.locateConfig( JGroupsChannelProvider.DEFAULT_JGROUPS_CONFIGURATION_FILE );
if ( fileUrl != null ) {
channel = new JChannel( fileUrl );
}
else {
log.jGroupsDefaultConfigurationFileNotFound();
channel = new JChannel();
}
}
catch ( Exception e ) {
throw log.unableToStartJGroupsChannel( e );
}
}
return channelIsManaged;
}
}