[wsmx-commits] components/core/src/main/ie/deri/wsmx/infomodel Adapter.java,1.3,1.4

[Laurentiu V. <lau...@us...>]

Update of /cvsroot/wsmx/components/core/src/main/ie/deri/wsmx/infomodel
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv4492/core/src/main/ie/deri/wsmx/infomodel

Added Files:
	Adapter.java 
Log Message:
adapter interface update 2: solved the import Document bug by adding the Document.java in the nonwsmodatamodel folder

--- NEW FILE: Adapter.java ---
/*
 * Copyright (c) 2005 National University of Ireland, Galway
 *
 * Licensed under MIT License
 * 
 * Permission is hereby granted, free of charge, to any person 
 * obtaining a copy of this software and associated 
 * documentation files (the "Software"), to deal in the Software 
 * without restriction, including without limitation the rights 
 * to use, copy, modify, merge, publish, distribute, sublicense, 
 * and/or sell copies of the Software, and to permit persons 
 * to whom the Software is furnished to do so, subject to the 
 * following conditions:
 *
 * The above copyright notice and this permission notice shall 
 * be included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
 * KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO 
 * THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR 
 * PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS 
 * OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES 
 * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT 
 * OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH 
 * THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

package ie.deri.wsmx.infomodel;

import ie.deri.wsmx.nonwsmodatamodel.Document;


/** 
 * 
 * An <b>Adapter</b> remains outside of WSMX system. That is why adapter does 
 * not extend <b>AbstractComponent</b> interface. 
 * <br/>
 * Adapters reside as an intermediary between incompatible 
 * systems and facilitate communication between them. 
 * To enable compatibility an adapter converts data presented 
 * in one format to another. Depending on the system and business 
 * application, adapters can be used individually or grouped in 
 * clusters for more complex usage. The clusters are designed as 
 * frameworks where adapters can be plugged -in or -out according to 
 * the communication needs.
 * <br/>
 * On the conceptual level, an adaptor transforms the received 
 * message from its source format to the target format. The 
 * transformation is concerned only with the syntactic mapping 
 * between message formats, leaving the semantics of the message 
 * intact. The semantic part is enforced by personalized ontologies 
 * that are used to build the outgoing message format. The main 
 * problem tackled by the WSMX adaptor framework is the transformation 
 * from other data formats into the language comprehensible by WSMX 
 * (WSML). The syntactic mapping between ontologies in different 
 * formats is done by extracting the instances from the source ontology 
 * fragment, then mapping them and finally populating the target 
 * WSML ontology fragment.
 * 
 * @author Michal Zaremba, Brahmananda Sapkota, Laurentiu Vasiliu
 *
 * Created on 10-Feb-2005
 * Committed by $Author: laurentiu $
 * 
 * $Source: /cvsroot/wsmx/components/core/src/main/ie/deri/wsmx/infomodel/Adapter.java,v $, 
 * @version $Revision: 1.4 $ $Date: 2005/02/28 11:34:07 $
 * 
 */

public interface Adapter {
	/**
     * @param document input document that contains a request message from the back-end application
     * @return document that contains response message from WSMX to back-end application.
     */
	public Document getRequest (Document document) throws Exception;
}