jp.preserv.service.xml
インタフェース XMLService

すべてのスーパーインタフェース:
Service
既知の実装クラスの一覧:
XMLServiceImpl

public interface XMLService
extends Service

本クラスはXMLサービスクラスです。XMLとJavaオブジェクトの変換を実施します。
本サービスはServiceLocatorクラス経由にて、サービスを取得して利用します。
以下に例を示します。 XMLService xmlSvs = (XMLService) ServiceLocator.get(ServiceKeys.XML_KEY); xmlSvs.setStrategyFactory("jp.co.melco.preserv.client.xml.XStreamDefaultXMLStrategy"); this.application = (ApplicationModel) xmlSvs.deSerialize(urlResourcePath); 本クラスは、変換処理を変更可能であり、ストラテジを設定することにより 変換処理を変更できます。上記コードのように、一度シリアライザを設定すると、 その変換仕様は保持されます。 また、一時的に設定済みのシリアライザを利用せず、指定シリアライザでシリアライズ、 デシリアライズを実行します。

バージョン:
1.00 H.WAKUI (MCR) 2007/02/16 初版
作成者:
H.WAKUI (MCR)
関連項目:
Service

メソッドの概要
 java.lang.Object deSerialize(java.lang.String resourcePath)
          リソース内からXMLを読み込み、Javaオブジェクトをデシアライズします。
 java.lang.Object deSerialize(java.net.URL urlResourcePath)
          URL上のXMLを読み込み、Javaオブジェクトをデシアライズします。
 java.lang.Object designatedDeserialize(java.lang.String resourcePath, java.lang.String strategyPath, java.lang.Object[] args)
          変換処理ストラテジを指定してリソース内からXMLを読み込み、Javaオブジェクトをデシアライズします。
 java.lang.Object designatedDeserialize(java.lang.String resourcePath, XMLStrategy strategy)
          変換処理ストラテジを指定してリソース内からXMLを読み込み、Javaオブジェクトをデシアライズします。
 java.lang.Object designatedDeserialize(java.net.URL urlResourcePath, java.lang.String strategyPath, java.lang.Object[] args)
          変換処理ストラテジを指定してURL上のXMLを読み込み、Javaオブジェクトをデシアライズします。
 java.lang.Object designatedDeserialize(java.net.URL urlResourcePath, XMLStrategy strategy)
          変換処理ストラテジを指定してURL上のXMLを読み込み、Javaオブジェクトをデシアライズします。
 void designatedSerialize(java.lang.Object target, java.lang.String toXmlFilePath, java.lang.String strategyPath, java.lang.Object[] args)
          変換処理ストラテジを指定してオブジェクトをXMLにシリアライズします。
 void designatedSerialize(java.lang.Object target, java.lang.String toXmlFilePath, XMLStrategy strategy)
          変換処理ストラテジを指定してオブジェクトをXMLにシリアライズします。
 boolean isExecutableState()
          現在、XMLサービス内部に保持するファクトリが実行可能な状態かどうかを戻します。
 void serialize(java.lang.Object target, java.lang.String toXmlFilePath)
          オブジェクトをXMLにシリアライズします。
 void setStrategyFactory(XMLStrategyFactory factory)
          XMLStrategyFactoryインタフェースを実装したストラテジのファクトリインスタンスを設定します。
 
インタフェース jp.preserv.service.Service から継承したメソッド
clear
 

メソッドの詳細

setStrategyFactory

public void setStrategyFactory(XMLStrategyFactory factory)
                        throws XMLServiceException
XMLStrategyFactoryインタフェースを実装したストラテジのファクトリインスタンスを設定します。

パラメータ:
factory - XMLStrategyFactoryの実装クラス
例外:
XMLServiceException - XMLStrategyFactory設定時に例外が発生した場合
関連項目:
XMLServiceException

isExecutableState

public boolean isExecutableState()
現在、XMLサービス内部に保持するファクトリが実行可能な状態かどうかを戻します。

戻り値:
ファクトリの実行可能状態(true:実行可能/false:実行不可能)

serialize

public void serialize(java.lang.Object target,
                      java.lang.String toXmlFilePath)
               throws XMLServiceException
オブジェクトをXMLにシリアライズします。
指定引数がNULL(空文字含む)もしくは不正であると例外が発生します。 またXMLStrategyFactoryが未設定の場合、例外が発生します。

パラメータ:
target - シリアライズする対象オブジェクト
toXmlFilePath - シリアライズしたXMLの格納場所
例外:
XMLServiceException - シリアライズ時に例外が発生した場合

deSerialize

public java.lang.Object deSerialize(java.net.URL urlResourcePath)
                             throws XMLServiceException
URL上のXMLを読み込み、Javaオブジェクトをデシアライズします。
指定引数がNULL(空文字含む)もしくは不正であると例外が発生します。 またXMLStrategyFactoryが未設定の場合、例外が発生します。

パラメータ:
urlResourcePath - URLリソースパス
戻り値:
デシアライズしたオブジェクト
例外:
XMLServiceException - デシリアライズ時に例外が発生した場合
関連項目:
XMLServiceException

deSerialize

public java.lang.Object deSerialize(java.lang.String resourcePath)
                             throws XMLServiceException
リソース内からXMLを読み込み、Javaオブジェクトをデシアライズします。
指定引数がNULL(空文字含む)もしくは不正であると例外が発生します。 またXMLStrategyFactoryが未設定の場合、例外が発生します。

パラメータ:
resourcePath - リソースパス
戻り値:
デシアライズしたオブジェクト
例外:
XMLServiceException - デシリアライズ時に例外が発生した場合
関連項目:
XMLServiceException

designatedSerialize

public void designatedSerialize(java.lang.Object target,
                                java.lang.String toXmlFilePath,
                                java.lang.String strategyPath,
                                java.lang.Object[] args)
                         throws XMLServiceException
変換処理ストラテジを指定してオブジェクトをXMLにシリアライズします。
指定引数がNULL(空文字含む)もしくは不正であると例外が発生します。 またXMLStrategyFactoryが未設定の場合、例外が発生します。

パラメータ:
target - シリアライズする対象オブジェクト
toXmlFilePath - シリアライズしたXMLの格納場所
strategyPath - XMLStrategyの実装クラスのパス
args - シリアライザをインスタンス化する際のコンストラクタ引数
例外:
XMLServiceException - シリアライズ時に例外が発生した場合
関連項目:
XMLServiceException, XMLStrategy

designatedSerialize

public void designatedSerialize(java.lang.Object target,
                                java.lang.String toXmlFilePath,
                                XMLStrategy strategy)
                         throws XMLServiceException
変換処理ストラテジを指定してオブジェクトをXMLにシリアライズします。
指定引数がNULL(空文字含む)もしくは不正であると例外が発生します。

パラメータ:
target - シリアライズする対象オブジェクト
toXmlFilePath - シリアライズしたXMLの格納パス
strategy - XMLStrategyの実装クラス
例外:
XMLServiceException - シリアライズ時に例外が発生した場合
関連項目:
XMLServiceException, XMLStrategy

designatedDeserialize

public java.lang.Object designatedDeserialize(java.net.URL urlResourcePath,
                                              java.lang.String strategyPath,
                                              java.lang.Object[] args)
                                       throws XMLServiceException
変換処理ストラテジを指定してURL上のXMLを読み込み、Javaオブジェクトをデシアライズします。
指定引数がNULL(空文字含む)もしくは不正であると例外が発生します。 またXMLStrategyFactoryが未設定の場合、例外が発生します。

パラメータ:
urlResourcePath - URLリソースパス
strategyPath - XMLStrategyの実装クラスのパス
args - シリアライザをインスタンス化する際のコンストラクタ引数
戻り値:
デシアライズしたオブジェクト
例外:
XMLServiceException - デシリアライズ時に例外が発生した場合
関連項目:
XMLServiceException, XMLStrategy

designatedDeserialize

public java.lang.Object designatedDeserialize(java.net.URL urlResourcePath,
                                              XMLStrategy strategy)
                                       throws XMLServiceException
変換処理ストラテジを指定してURL上のXMLを読み込み、Javaオブジェクトをデシアライズします。
指定引数がNULL(空文字含む)もしくは不正であると例外が発生します。

パラメータ:
urlResourcePath - URLリソースパス
strategy - XMLStrategyの実装クラス
戻り値:
デシアライズしたオブジェクト
例外:
XMLServiceException - デシリアライズ時に例外が発生した場合
関連項目:
XMLServiceException, XMLStrategy

designatedDeserialize

public java.lang.Object designatedDeserialize(java.lang.String resourcePath,
                                              java.lang.String strategyPath,
                                              java.lang.Object[] args)
                                       throws XMLServiceException
変換処理ストラテジを指定してリソース内からXMLを読み込み、Javaオブジェクトをデシアライズします。
指定引数がNULL(空文字含む)もしくは不正であると例外が発生します。 またXMLStrategyFactoryが未設定の場合、例外が発生します。

パラメータ:
resourcePath - リソースパス
strategyPath - XMLStrategyの実装クラスのパス
args - シリアライザをインスタンス化する際のコンストラクタ引数
戻り値:
デシアライズしたオブジェクト
例外:
XMLServiceException - デシリアライズ時に例外が発生した場合
関連項目:
XMLServiceException, XMLStrategy

designatedDeserialize

public java.lang.Object designatedDeserialize(java.lang.String resourcePath,
                                              XMLStrategy strategy)
                                       throws XMLServiceException
変換処理ストラテジを指定してリソース内からXMLを読み込み、Javaオブジェクトをデシアライズします。
指定引数がNULL(空文字含む)もしくは不正であると例外が発生します。 またXMLStrategyFactoryが未設定の場合、例外が発生します。

パラメータ:
resourcePath - リソースパス
strategy - XMLStrategyの実装クラス
戻り値:
デシアライズしたオブジェクト
例外:
XMLServiceException - デシリアライズ時に例外が発生した場合
関連項目:
XMLServiceException, XMLStrategy