CtxBrokerClient.java

/**
 * Copyright (c) 2011, SOCIETIES Consortium (WATERFORD INSTITUTE OF TECHNOLOGY (TSSG), HERIOT-WATT UNIVERSITY (HWU), SOLUTA.NET 
 * (SN), GERMAN AEROSPACE CENTRE (Deutsches Zentrum fuer Luft- und Raumfahrt e.V.) (DLR), Zavod za varnostne tehnologije
 * informacijske družbe in elektronsko poslovanje (SETCCE), INSTITUTE OF COMMUNICATION AND COMPUTER SYSTEMS (ICCS), LAKE
 * COMMUNICATIONS (LAKE), INTEL PERFORMANCE LEARNING SOLUTIONS LTD (INTEL), PORTUGAL TELECOM INOVAÇÃO, SA (PTIN), IBM Corp., 
 * INSTITUT TELECOM (ITSUD), AMITEC DIACHYTI EFYIA PLIROFORIKI KAI EPIKINONIES ETERIA PERIORISMENIS EFTHINIS (AMITEC), TELECOM 
 * ITALIA S.p.a.(TI),  TRIALOG (TRIALOG), Stiftelsen SINTEF (SINTEF), NEC EUROPE LTD (NEC))
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following
 * conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
 *    disclaimer in the documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
 * SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

package org.societies.android.platform.ctxclient.comm;

import java.io.Serializable;
import java.util.Arrays;
import java.util.List;

import org.societies.api.comm.xmpp.datatypes.Stanza;
import org.societies.api.comm.xmpp.datatypes.XMPPInfo;
import org.societies.api.comm.xmpp.exceptions.CommunicationException;
import org.societies.api.comm.xmpp.exceptions.XMPPError;
import org.societies.api.comm.xmpp.interfaces.ICommCallback;
import org.societies.api.comm.xmpp.interfaces.ICommManager;
import org.societies.api.context.CtxException;
import org.societies.android.api.context.model.ACtxAttributeIdentifier;
import org.societies.android.api.context.model.ACtxEntityIdentifier;
import org.societies.android.api.context.model.ACtxIdentifier;
import org.societies.android.api.context.model.CtxModelBeanTranslator;
import org.societies.android.api.context.model.ACtxModelObject;
import org.societies.api.context.model.CtxModelType;
import org.societies.api.identity.IIdentity;
import org.societies.api.identity.IIdentityManager;
import org.societies.api.identity.Requestor;
import org.societies.api.identity.RequestorCis;
import org.societies.api.identity.RequestorService;
import org.societies.api.schema.context.contextmanagement.BrokerMethodBean;
import org.societies.api.schema.context.contextmanagement.CreateAssociationBean;
import org.societies.api.schema.context.contextmanagement.CreateAttributeBean;
import org.societies.api.schema.context.contextmanagement.CreateEntityBean;
import org.societies.api.schema.context.contextmanagement.CtxBrokerRequestBean;
import org.societies.api.schema.context.contextmanagement.LookupBean;
import org.societies.api.schema.context.contextmanagement.RemoveBean;
import org.societies.api.schema.context.contextmanagement.RetrieveBean;
import org.societies.api.schema.context.contextmanagement.RetrieveCommunityEntityIdBean;
import org.societies.api.schema.context.contextmanagement.RetrieveIndividualEntityIdBean;
import org.societies.api.schema.context.contextmanagement.UpdateAttributeBean;
import org.societies.api.schema.context.contextmanagement.UpdateBean;
import org.societies.api.schema.context.model.CtxEntityIdentifierBean;
import org.societies.api.schema.context.model.CtxIdentifierBean;
import org.societies.api.schema.context.model.CtxModelObjectBean;
import org.societies.api.schema.identity.RequestorBean;
import org.societies.api.schema.identity.RequestorCisBean;
import org.societies.api.schema.identity.RequestorServiceBean;
import org.societies.android.platform.ctxclient.api.CtxBrokerException;

import android.util.Log;

public class CtxBrokerClient implements ICommCallback {

	private static final String LOG_TAG = CtxBrokerClient.class.getName();

	private static final List<String> ELEMENT_NAMES = Arrays.asList("BrokerMethodBean", "CreateAssociationBean", 
			"CreateAttributeBean", "CreateEntityBean", "CtxBrokerRequestBean", "LookupBean", "RemoveBean", "RetrieveBean", 
			"RetrieveCommunityEntityIdBean", "RetrieveIndividualEntityIdBean", "UpdateAttributeBean", "UpdateBean", 
			"CtxEntityIdentifierBean", "CtxIdentifierBean", "CtxModelObjectBean", "RequestorBean", "RequestorCisBean", 
			"RequestorServiceBean");

	private final static List<String> NAME_SPACES = Arrays.asList(
			"http://societies.org/api/schema/identity",
			"http://societies.org/api/schema/context/model",
			"http://societies.org/api/schema/context/contextmanagement");
	private static final List<String> PACKAGES = Arrays.asList(
			"org.societies.api.schema.identity",
			"org.societies.api.schema.context.model",
			"org.societies.api.schema.context.contextmanagement");

	private ICommManager commManager;

	private IIdentityManager idMgr;

	private CtxBrokerCommCallback ctxBrokerCommCallback = new CtxBrokerCommCallback();

	public ICommManager getCommManager() {
		return commManager;
	}

	public void setCommManager(ICommManager commManager) {
		this.commManager = commManager;
	}

	/**
	 * The Ctx Broker Client service reference.
	 *
	 * @see {@link #setCtxBrokerClient()}
	 */
	CtxBrokerClient(ICommManager commManager) throws CommunicationException {
		
		Log.i(LOG_TAG, this.getClass() + "instansiated");
		
		this.commManager = commManager;
		this.commManager.register(this);
		this.idMgr = this.commManager.getIdManager();
	}

	public void createEntity(Requestor requestor, IIdentity targetCss, 
			String type, ICtxCallback callback) throws CtxException {

		IIdentity toIdentity;
		try {
			toIdentity = targetCss;
			Stanza stanza = new Stanza(toIdentity);
			CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			cbPacket.setMethod(BrokerMethodBean.CREATE_ENTITY);
			
			CreateEntityBean ctxBrokerCreateEntityBean = new CreateEntityBean();
			RequestorBean requestorBean = createRequestorBean(requestor);
			ctxBrokerCreateEntityBean.setRequestor(requestorBean);
			ctxBrokerCreateEntityBean.setTargetCss(toIdentity.getBareJid());
			ctxBrokerCreateEntityBean.setType(type);
			
			cbPacket.setCreateEntity(ctxBrokerCreateEntityBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);

			this.commManager.sendIQGet(stanza, cbPacket, this.ctxBrokerCommCallback);
			
		} catch (Exception e) {

			throw new CtxBrokerException("Could not create remote entity: "
					+ e.getLocalizedMessage(), e);
		} 
	}
	
	public void createAttribute(Requestor requestor, IIdentity targetCss, ACtxEntityIdentifier scope, String type, ICtxCallback callback) throws CtxBrokerException{

		IIdentity toIdentity ;
		try {
			toIdentity = targetCss;
			Stanza stanza = new Stanza(toIdentity);
			CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			cbPacket.setMethod(BrokerMethodBean.CREATE_ATTRIBUTE);
			
			CreateAttributeBean ctxBrokerCreateAttributeBean = new CreateAttributeBean();
			// 1. set requestorBean
			RequestorBean requestorBean = createRequestorBean(requestor);
			ctxBrokerCreateAttributeBean.setRequestor(requestorBean);
			// 2. set scope
			CtxEntityIdentifierBean ctxEntIdBean = new CtxEntityIdentifierBean();
			ctxEntIdBean.setString(scope.toString());
			ctxBrokerCreateAttributeBean.setScope(ctxEntIdBean);
			// 3. set type
			ctxBrokerCreateAttributeBean.setType(type);
			
			cbPacket.setCreateAttribute(ctxBrokerCreateAttributeBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);

			this.commManager.sendIQGet(stanza, cbPacket, this.ctxBrokerCommCallback);

		} catch (Exception e) {

			throw new CtxBrokerException("Could not create remote attribute: "
					+ e.getLocalizedMessage(), e);
		} 

	}

	public void createAssociation(Requestor requestor, IIdentity targetCss, String type, ICtxCallback callback) throws CtxBrokerException {

		IIdentity toIdentity = targetCss;
		try {
			Stanza stanza = new Stanza(toIdentity);

			CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			cbPacket.setMethod(BrokerMethodBean.CREATE_ASSOCIATION);

			CreateAssociationBean ctxBrokerCreateAssociationBean = new CreateAssociationBean();
			RequestorBean requestorBean = createRequestorBean(requestor);
			ctxBrokerCreateAssociationBean.setRequestor(requestorBean);
			ctxBrokerCreateAssociationBean.setType(type);
			ctxBrokerCreateAssociationBean.setTargetCss(toIdentity.getBareJid());

			cbPacket.setCreateAssociation(ctxBrokerCreateAssociationBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);
			
			this.commManager.sendIQGet(stanza, cbPacket, this.ctxBrokerCommCallback);

		} catch (Exception e) {
			
			throw new CtxBrokerException("Could not create remote association: "
					+ e.getLocalizedMessage(), e);
			
		}
	}
	
	public void retrieve(Requestor requestor, ACtxIdentifier identifier,
			ICtxCallback callback) throws CtxBrokerException  {

		IIdentity toIdentity = null;
		try {
			toIdentity = this.commManager.getIdManager().fromJid(identifier.getOwnerId());
			Stanza stanza = new Stanza(toIdentity);
			CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			cbPacket.setMethod(BrokerMethodBean.RETRIEVE);

			// use the method : retrieve
			RetrieveBean ctxBrokerRetrieveBean = new RetrieveBean();
			CtxModelBeanTranslator ctxBeanTranslator = CtxModelBeanTranslator.getInstance();
			// add the signatures of the method
			CtxIdentifierBean ctxIdBean = ctxBeanTranslator.fromCtxIdentifier(identifier);
			ctxBrokerRetrieveBean.setId(ctxIdBean);
			RequestorBean requestorBean = createRequestorBean(requestor);
			ctxBrokerRetrieveBean.setRequestor(requestorBean);

			cbPacket.setRetrieve(ctxBrokerRetrieveBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);

			this.commManager.sendIQGet(stanza, cbPacket, this.ctxBrokerCommCallback);
			
		} catch (Exception e) {
			
			throw new CtxBrokerException("Could not retrieve remote ctx model object "
					+ identifier + ": " + e.getLocalizedMessage(), e);
		}
	}

	public void retrieveIndividualEntityId(Requestor requestor, 
			IIdentity targetCss, ICtxCallback callback) throws CtxBrokerException {

		IIdentity toIdentity = null;
		try {
			toIdentity = targetCss;
			Stanza stanza = new Stanza(toIdentity);
			CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			cbPacket.setMethod(BrokerMethodBean.RETRIEVE_INDIVIDUAL_ENTITY_ID);

			RetrieveIndividualEntityIdBean retrieveIndEntBean = new RetrieveIndividualEntityIdBean();
			//1.requestor
			RequestorBean requestorBean = createRequestorBean(requestor);
			retrieveIndEntBean.setRequestor(requestorBean);
			//2. target id
			retrieveIndEntBean.setTargetCss(toIdentity.getJid());

			cbPacket.setRetrieveIndividualEntityId(retrieveIndEntBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);
			
			this.commManager.sendIQGet(stanza, cbPacket, this.ctxBrokerCommCallback);
			
		} catch (CommunicationException e) {

			throw new CtxBrokerException("Could not retrieve remote individual ctx entity : "
					+ e.getLocalizedMessage(), e);
		}

	}
	
	public void retrieveCommunityEntityId(Requestor requestor, IIdentity target,
			ICtxCallback callback) throws CtxBrokerException {

		try {
			final Stanza stanza = new Stanza(target);
			final CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			cbPacket.setMethod(BrokerMethodBean.RETRIEVE_COMMUNITY_ENTITY_ID);

			final RetrieveCommunityEntityIdBean methodBean = new RetrieveCommunityEntityIdBean();

			// 1. requestor
			final RequestorBean requestorBean = this.createRequestorBean(requestor);
			methodBean.setRequestor(requestorBean);
			// 2. target id
			methodBean.setTarget(target.getJid());
			cbPacket.setRetrieveCommunityEntityId(methodBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);
			
			this.commManager.sendIQGet(stanza, cbPacket, this.ctxBrokerCommCallback);
			
		} catch (Exception e) {

			throw new CtxBrokerException("Could not retrieve remote community ctx entity for '"
					+ target + "': " + e.getLocalizedMessage(), e);
		}

	}
	
	public void update(Requestor requestor, ACtxModelObject object, 
			ICtxCallback callback) throws CtxBrokerException {

		IIdentity toIdentity = null;
		try {
			toIdentity = this.commManager.getIdManager().fromJid(object.getOwnerId());
			Stanza stanza = new Stanza(toIdentity);
			// create request bean
			CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			// method type
			cbPacket.setMethod(BrokerMethodBean.UPDATE);
			// method bean
			UpdateBean ctxBrokerUpdateBean = new UpdateBean();
			RequestorBean requestorBean = this.createRequestorBean(requestor);
			ctxBrokerUpdateBean.setRequestor(requestorBean);
			CtxModelBeanTranslator ctxBeanTranslator = CtxModelBeanTranslator.getInstance();
			CtxModelObjectBean objectBean = ctxBeanTranslator.fromCtxModelObject(object);
			ctxBrokerUpdateBean.setCtxModelOject(objectBean);
			cbPacket.setUpdate(ctxBrokerUpdateBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);

			this.commManager.sendIQGet(stanza, cbPacket, this.ctxBrokerCommCallback);
			
		} catch (Exception e) {
			
			throw new CtxBrokerException("Could not update context model object "
					+ object.getId() + ": " + e.getLocalizedMessage(), e);
		}
	}
	
	public void updateAttribute(Requestor requestor, 
			ACtxAttributeIdentifier attributeId, Serializable value, 
			ICtxCallback callback) throws CtxBrokerException {

		IIdentity toIdentity = null;
		try {
			toIdentity = this.commManager.getIdManager().fromJid(attributeId.getOwnerId());
			Stanza stanza = new Stanza(toIdentity);
			// create request bean
			CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			// method type
			// TODO UPDATE_ATTRIBUTE ??
			cbPacket.setMethod(BrokerMethodBean.UPDATE);
			// method bean
			UpdateAttributeBean ctxBrokerUpdateAttributeBean = new UpdateAttributeBean();
			// TODO
			/*CtxAttributeIdentifierBean ctxAttrIdBean = new CtxAttributeIdentifierBean();
			ctxAttrIdBean.setString(attributeId.toString());
			ctxBrokerUpdateAttributeBean.setAttrId(ctxAttrIdBean);

			//ctxBrokerUpdateAttributeBean.setRequester("FOO");
			RequestorBean requestorBean = createRequestorBean(requestor);
			ctxBrokerUpdateAttributeBean.setRequestor(requestorBean);

			ctxBrokerUpdateAttributeBean.setValue((byte[]) value);
			*/
			cbPacket.setUpdateAttribute(ctxBrokerUpdateAttributeBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);

			this.commManager.sendIQGet(stanza, ctxBrokerUpdateAttributeBean, this.ctxBrokerCommCallback);
			 
		} catch (Exception e) {
			
			throw new CtxBrokerException("Could not update context attribute "
					+ attributeId + ": " + e.getLocalizedMessage(), e);
		}
	
	}
	
	public void remove(Requestor requestor, ACtxIdentifier identifier, 
			ICtxCallback callback) throws CtxBrokerException {

		IIdentity toIdentity = null;
		try {
			toIdentity = this.commManager.getIdManager().fromJid(identifier.getOwnerId());
			Stanza stanza = new Stanza(toIdentity);
			// create request bean
			CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			// method type
			cbPacket.setMethod(BrokerMethodBean.REMOVE);
			// method bean
			RemoveBean ctxBrokerRemoveBean = new RemoveBean();
			ctxBrokerRemoveBean.setRequestor(this.createRequestorBean(requestor));
			ctxBrokerRemoveBean.setId(CtxModelBeanTranslator.getInstance().fromCtxIdentifier(identifier));
			cbPacket.setRemove(ctxBrokerRemoveBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);
				
			this.commManager.sendIQGet(stanza, cbPacket, this.ctxBrokerCommCallback);

		} catch (Exception e) {
			
			throw new CtxBrokerException("Could not remove context model object "
					+ identifier + ": " + e.getLocalizedMessage(), e);
		}
	}
	
	public void lookup(Requestor requestor, IIdentity targetCss, 
			CtxModelType modelType, String type, ICtxCallback callback)
					throws CtxBrokerException {
		
		IIdentity toIdentity = null;
		try {
			toIdentity = targetCss;
			Stanza stanza = new Stanza(toIdentity);
			// create request bean
			CtxBrokerRequestBean cbPacket = new CtxBrokerRequestBean();
			// method type
			cbPacket.setMethod(BrokerMethodBean.LOOKUP);
			// method bean
			LookupBean ctxBrokerLookupBean = new LookupBean();
			
			// 1. requestor
			ctxBrokerLookupBean.setRequestor(this.createRequestorBean(requestor));
			// 2. target id
			ctxBrokerLookupBean.setTargetCss(toIdentity.getBareJid());
			// 3. model type
			ctxBrokerLookupBean.setModelType(
					CtxModelBeanTranslator.getInstance().CtxModelTypeBeanFromCtxModelType(modelType));
			// 4 . type
			ctxBrokerLookupBean.setType(type);
			cbPacket.setLookup(ctxBrokerLookupBean);

			this.ctxBrokerCommCallback.addRequestingClient(stanza.getId(), callback);

			this.commManager.sendIQGet(stanza, cbPacket, this.ctxBrokerCommCallback);
			
		} catch (Exception e) {
			
			throw new CtxBrokerException("Could not perform remote lookup: "
					+ e.getLocalizedMessage(), e);
		} 
	}

	private RequestorBean createRequestorBean(Requestor requestor){
		if (requestor instanceof RequestorCis){
			RequestorCisBean cisRequestorBean = new RequestorCisBean();
			cisRequestorBean.setRequestorId(requestor.getRequestorId().getBareJid());
			cisRequestorBean.setCisRequestorId(((RequestorCis) requestor).getCisRequestorId().getBareJid());
			return cisRequestorBean;
		}else if (requestor instanceof RequestorService){
			RequestorServiceBean serviceRequestorBean = new RequestorServiceBean();
			serviceRequestorBean.setRequestorId(requestor.getRequestorId().getBareJid());
			serviceRequestorBean.setRequestorServiceId(((RequestorService) requestor).getRequestorServiceId());
			return serviceRequestorBean;
		}else{
			RequestorBean requestorBean = new RequestorBean();
			requestorBean.setRequestorId(requestor.getRequestorId().getBareJid());
			return requestorBean;
		}
	}

	public List<String> getJavaPackages() {
		return PACKAGES;
	}

	public List<String> getXMLNamespaces() {
		return NAME_SPACES;
	}

	public void receiveError(Stanza arg0, XMPPError arg1) {
		// TODO Auto-generated method stub

	}

	public void receiveInfo(Stanza arg0, String arg1, XMPPInfo arg2) {
		// TODO Auto-generated method stub

	}

	public void receiveItems(Stanza arg0, String arg1, List<String> arg2) {
		// TODO Auto-generated method stub

	}

	public void receiveMessage(Stanza arg0, Object arg1) {
		// TODO Auto-generated method stub

	}

	public void receiveResult(Stanza arg0, Object arg1) {
		// TODO Auto-generated method stub

	}
}