org.mobicents.slee.annotations.examples.sbb.SimpleExampleAnnotatedSbb Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jain-slee-11-ext Show documentation
The newest version!
/*
 * JBoss, Home of Professional Open Source
 * Copyright 2011, Red Hat, Inc. and individual contributors
 * by the @authors tag. See the copyright.txt in the distribution for a
 * full listing of individual contributors.
 *
 * This is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * This software 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 software; if not, write to the Free
 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
 */

package org.mobicents.slee.annotations.examples.sbb;

import javax.slee.ActivityContextInterface;
import javax.slee.facilities.TimerEvent;
import javax.slee.facilities.TimerOptions;
import javax.slee.facilities.Tracer;
import javax.slee.serviceactivity.ServiceStartedEvent;

import org.mobicents.slee.ConfigProperties;
import org.mobicents.slee.SbbContextExt;
import org.mobicents.slee.SbbExt;
import org.mobicents.slee.annotations.CMPField;
import org.mobicents.slee.annotations.Sbb;
import org.mobicents.slee.annotations.SbbContextExtField;
import org.mobicents.slee.annotations.Service;
import org.mobicents.slee.annotations.ServiceStartedEventHandler;
import org.mobicents.slee.annotations.TimerEventHandler;
import org.mobicents.slee.annotations.TracerField;

/**
 * Simple example for an annotated Sbb, on service start fires a 1 sec timer and
 * on timer event calculates real delay. Examples CMP Field and facilities
 * injection too.
 * 
 * A service is defined by applying the {@link Service} annotation too.
 * 
 * Extends {@link SbbExt} instead of implementing {@link Sbb}, besides access to
 * {@link SbbContextExt} and {@link ConfigProperties}, not used in the example,
 * there is no need to define sbb lifecycle methods not used.
 * 
 * Regarding field injection: 
 * - "default" tracer and SbbContextExt injected before setSbbContext()
 * - by applying CMPField annotation to field, value is
 * injected before sbbLoad(), and persisted after sbbStore(), in case applied to
 * method it identifies one of the CMP Field accessors.
 * 
 * A few more notes about event handler method annotations:
 * - initialEventSelect is { InitialEventSelect.ActivityContext } by default
 * - initialEvent is false by default
 * 
 * @author Eduardo Martins
 * 
 */
@Service(name="ExampleSbb",vendor="javax.slee",version="1.0",
		rootSbb=SimpleExampleAnnotatedSbb.class)
@Sbb(name="ExampleSbb",vendor="javax.slee",version="1.0")
public abstract class SimpleExampleAnnotatedSbb implements SbbExt {

	private static final long TIMER_DURATION = 1000;
	
	@TracerField
	private Tracer tracer;
	
	@SbbContextExtField
	private SbbContextExt sbbContextExt;
	
	@CMPField
	private Long startTime;
	
	@ServiceStartedEventHandler
	public void onServiceStartedEvent(ServiceStartedEvent event,
			ActivityContextInterface aci) {
		tracer.info("service started");
		sbbContextExt.getTimerFacility().setTimer(aci, null, TIMER_DURATION,
				new TimerOptions());
		startTime = Long.valueOf(System.currentTimeMillis());
	}
	
	@TimerEventHandler
	public void onTimerEvent(TimerEvent event, ActivityContextInterface aci) {
		long delay = (System.currentTimeMillis()-TIMER_DURATION) - startTime;
		tracer.info("timer expired, delay = "+delay+" ms.");
	}
}