RtpContentService.java

/*
 * (C) Copyright 2013 Kurento (http://kurento.org/)
 *
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the GNU Lesser General Public License
 * (LGPL) version 2.1 which accompanies this distribution, and is available at
 * http://www.gnu.org/licenses/lgpl-2.1.html
 *
 * This library 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.
 *
 */
package com.kurento.kmf.content;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 
 * Annotation for the implementation of a RtpContentHandler; it should be used
 * in conjunction within the implementation of the {@link RtpContentHandler}
 * interface. The following snippet shows an skeleton with the implementation of
 * a RTP Handler:
 * 
 * <pre>
 * <code>
 * @RtpMediaService(name = "MyRtpHandler", path = "/my-rtp-media")
 * public class MyHandler implements RtpContentHandler {
 * 
 * 	@Override
 * 	public void onContentRequest(RtpContentSession session) throws ContentException {
 * 		// My implementation
 * 	}
 * 
 * 	@Override
 * 	public void onSessionTerminated(RtpContentSession session, int code, String reason) {
 * 		// My implementation
 * 	}
 * 
 * 	@Override
 * 	public onSessionError(RtpContentSession session, int code, String reason) {
 * 		// My implementation
 * 	}
 * 
 * }
 * </code>
 * </pre>
 * 
 * @see RtpContentHandler
 * @author Luis López (llopez@gsyc.es)
 * @version 1.0.0
 */
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface RtpContentService {

	/**
	 * Name of the RTP Handler; this name MUST be unique; in other words, in
	 * several handlers exists within the same application, each of them must
	 * have a different name.
	 * 
	 */
	String name() default "";

	/**
	 * The handler will be instrumented as a HTTP Servlet in the application
	 * server; this parameter establishes the path of the servlet; the same way
	 * as the name, if several handlers co-exists within the same application,
	 * the paths must be also different.
	 */
	String path();
}