/*
 * Copyright (C) 2005-2006 Kouji Sugisawa. All rights reserved.
 */

package jp.sourceforge.livez;

import javax.servlet.http.HttpServletRequest;

import org.springframework.web.context.WebApplicationContext;

/**
 * 通信サービス検証用のインターフェイスです。
 * 
 * @author 杉澤 浩二
 */
public interface Service<R extends MobilePhoneRequest, G extends MobilePhoneGenerator> {

	/**
	 * HTTP リクエスト情報を解析し携帯端末リクエスト情報を返します。
	 * 
	 * @param request HTTP リクエスト情報
	 * @return 携帯端末リクエスト情報
	 * @throws NullPointerException HTTPリクエスト情報が <code>null</code> の場合
	 * @throws IllegalRequestException HTTPリクエスト情報が不正な場合
	 */
	public R getMobilePhoneRequest(HttpServletRequest request) throws NullPointerException, IllegalRequestException;

	/**
	 * 通信サービスに適合する携帯端末情報ジェネレータを返します。
	 * 
	 * @param context Spring Framework の WebApplicationContext
	 * @return 携帯端末情報ジェネレータ
	 */
	public G getMobilePhoneGenerator(WebApplicationContext context);

}
