com.envision.energy.eos.sdk.IDataService Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of enos-subscribe Show documentation

enos subscription service

There is a newer version: 3.0.3

package com.envision.energy.eos.sdk;

import java.util.Collection;

import com.envision.energy.eos.exception.SubscribeException;

public interface IDataService {
	
	/**
	 * @deprecated
	 * @param handler
	 * subscribe all devices' data.
	 * data reading process is in handler.
	 * @throws NullPointerException
	 * @throws SubscribeException
	 */
	void subscribe(IDataHandler handler) 
			throws NullPointerException, SubscribeException;
	/**
	 * @param handler
	 * @param points
	 * subscribe data by PointInfos which contain device id and point id.
	 * data reading process is in handler.
	 * @throws NullPointerException
	 * @throws SubscribeException
	 */
	void subscribe(IDataHandler handler, Collection points) 
			throws NullPointerException, SubscribeException;
	/**
	 * @deprecated
	 * @param handler
	 * @param pointIds
	 * @param domainIds
	 * subscribe data by point ids.
	 * data reading process is in handler.
	 * @throws NullPointerException
	 * @throws SubscribeException
	 */
	void subscribe(IDataHandler handler, Collection pointIds, String... domainIds) 
			throws NullPointerException, SubscribeException;
	
	/**
	 * unsubscribe data.
	 * if data processing is finished, you can subscribe again.
	 * @param handler
	 
	 * @throws SubscribeException
	 */
	void unsubscribe(IDataHandler handler) throws NullPointerException, SubscribeException;
	
	public void unsubscribe(IDataHandler handler,Collection pointIds, String domainId)
			throws NullPointerException, SubscribeException;
			
	/**
	 * @param handler
	 * @param pointIds
	 * @param domainIds
	 * @throws NullPointerException
	 * @throws SubscribeException
	 */
	void subscribe(IPointCalHandler handler, Collection pointIds, String... domainIds) 
			throws NullPointerException, SubscribeException;
	
	void shutdown();
}