-/*\r
- * //******************************************************************\r
- * //\r
- * // Copyright 2015 Intel Corporation.\r
- * //\r
- * //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
- * //\r
- * // Licensed under the Apache License, Version 2.0 (the "License");\r
- * // you may not use this file except in compliance with the License.\r
- * // You may obtain a copy of the License at\r
- * //\r
- * // http://www.apache.org/licenses/LICENSE-2.0\r
- * //\r
- * // Unless required by applicable law or agreed to in writing, software\r
- * // distributed under the License is distributed on an "AS IS" BASIS,\r
- * // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
- * // See the License for the specific language governing permissions and\r
- * // limitations under the License.\r
- * //\r
- * //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
- */\r
-\r
-package org.iotivity.base;\r
-\r
-import java.util.List;\r
-import java.util.Map;\r
-\r
-/**\r
- * OcResource represents an OC resource. A resource could be a light controller, temperature sensor,\r
- * smoke detector, etc. A resource comes with a well-defined contract or interface onto which you\r
- * can perform different operations, such as turning on the light, getting the current temperature\r
- * or subscribing for event notifications from the smoke detector. A resource can be composed of\r
- * one or more resources.\r
- */\r
-public class OcResource {\r
-\r
- private OcResource(long nativeHandle) {\r
- this.mNativeHandle = nativeHandle;\r
- }\r
-\r
- /**\r
- * Method to get the attributes of a resource.\r
- *\r
- * @param queryParamsMap map which can have the query parameter name and value\r
- * @param onGetListener The event handler will be invoked with a map of attribute name and\r
- * values. The event handler will also have the result from this Get\r
- * operation This will have error codes\r
- * @throws OcException\r
- */\r
- public native void get(Map<String, String> queryParamsMap,\r
- OnGetListener onGetListener) throws OcException;\r
-\r
- /**\r
- * Method to get the attributes of a resource.\r
- *\r
- * @param queryParamsMap map which can have the query parameter name and value\r
- * @param onGetListener The event handler will be invoked with a map of attribute name and\r
- * values. The event handler will also have the result from this Get\r
- * operation This will have error codes\r
- * @param qualityOfService the quality of communication\r
- * @throws OcException\r
- */\r
- public void get(Map<String, String> queryParamsMap,\r
- OnGetListener onGetListener,\r
- QualityOfService qualityOfService) throws OcException {\r
- this.get1(queryParamsMap, onGetListener, qualityOfService.getValue());\r
- }\r
-\r
- private native void get1(Map<String, String> queryParamsMap,\r
- OnGetListener onGetListener,\r
- int qualityOfService) throws OcException;\r
-\r
- /**\r
- * Method to get the attributes of a resource.\r
- *\r
- * @param resourceType resourceType of the resource to operate on\r
- * @param resourceInterface interface type of the resource to operate on\r
- * @param queryParamsMap map which can have the query parameter name and value\r
- * @param onGetListener The event handler will be invoked with a map of attribute name and\r
- * values. The event handler will also have the result from this Get\r
- * operation This will have error codes\r
- * @throws OcException\r
- */\r
- public void get(String resourceType,\r
- String resourceInterface,\r
- Map<String, String> queryParamsMap,\r
- OnGetListener onGetListener) throws OcException {\r
- this.get2(\r
- resourceType,\r
- resourceInterface,\r
- queryParamsMap,\r
- onGetListener);\r
- }\r
-\r
- private native void get2(String resourceType,\r
- String resourceInterface,\r
- Map<String, String> queryParamsMap,\r
- OnGetListener onGetListener) throws OcException;\r
-\r
- /**\r
- * Method to get the attributes of a resource.\r
- *\r
- * @param resourceType resourceType of the resource to operate on\r
- * @param resourceInterface interface type of the resource to operate on\r
- * @param queryParamsMap map which can have the query parameter name and value\r
- * @param onGetListener The event handler will be invoked with a map of attribute name and\r
- * values. The event handler will also have the result from this Get\r
- * operation This will have error codes\r
- * @param qualityOfService the quality of communication\r
- * @throws OcException\r
- */\r
- public void get(String resourceType,\r
- String resourceInterface,\r
- Map<String, String> queryParamsMap,\r
- OnGetListener onGetListener,\r
- QualityOfService qualityOfService) throws OcException {\r
- this.get3(\r
- resourceType,\r
- resourceInterface,\r
- queryParamsMap,\r
- onGetListener,\r
- qualityOfService.getValue());\r
- }\r
-\r
- private native void get3(String resourceType,\r
- String resourceInterface,\r
- Map<String, String> queryParamsMap,\r
- OnGetListener onGetListener,\r
- int qualityOfService) throws OcException;\r
-\r
- /**\r
- * Method to set the representation of a resource (via PUT)\r
- *\r
- * @param representation representation of the resource\r
- * @param queryParamsMap Map which can have the query parameter name and value\r
- * @param onPutListener event handler The event handler will be invoked with a map of attribute\r
- * name and values.\r
- * @throws OcException\r
- */\r
- public native void put(OcRepresentation representation,\r
- Map<String, String> queryParamsMap,\r
- OnPutListener onPutListener) throws OcException;\r
-\r
- /**\r
- * Method to set the representation of a resource (via PUT)\r
- *\r
- * @param ocRepresentation representation of the resource\r
- * @param queryParamsMap Map which can have the query parameter name and value\r
- * @param onPutListener event handler The event handler will be invoked with a map of\r
- * attribute name and values.\r
- * @param qualityOfService the quality of communication\r
- * @throws OcException\r
- */\r
- public void put(OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPutListener onPutListener,\r
- QualityOfService qualityOfService) throws OcException {\r
- this.put1(\r
- ocRepresentation,\r
- queryParamsMap,\r
- onPutListener,\r
- qualityOfService.getValue());\r
- }\r
-\r
- private native void put1(OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPutListener onPutListener,\r
- int qualityOfService) throws OcException;\r
-\r
- /**\r
- * Method to set the representation of a resource (via PUT)\r
- *\r
- * @param resourceType resource type of the resource to operate on\r
- * @param resourceInterface interface type of the resource to operate on\r
- * @param ocRepresentation representation of the resource\r
- * @param queryParamsMap Map which can have the query parameter name and value\r
- * @param onPutListener event handler The event handler will be invoked with a map of\r
- * attribute name and values.\r
- * @throws OcException\r
- */\r
- public void put(String resourceType,\r
- String resourceInterface,\r
- OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPutListener onPutListener) throws OcException {\r
- this.put2(\r
- resourceType,\r
- resourceInterface,\r
- ocRepresentation,\r
- queryParamsMap,\r
- onPutListener);\r
- }\r
-\r
- private native void put2(String resourceType,\r
- String resourceInterface,\r
- OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPutListener onPutListener) throws OcException;\r
-\r
- /**\r
- * Method to set the representation of a resource (via PUT)\r
- *\r
- * @param resourceType resource type of the resource to operate on\r
- * @param resourceInterface interface type of the resource to operate on\r
- * @param ocRepresentation representation of the resource\r
- * @param queryParamsMap Map which can have the query parameter name and value\r
- * @param onPutListener event handler The event handler will be invoked with a map of\r
- * attribute name and values.\r
- * @param qualityOfService the quality of communication\r
- * @throws OcException\r
- */\r
- public void put(String resourceType,\r
- String resourceInterface,\r
- OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPutListener onPutListener,\r
- QualityOfService qualityOfService) throws OcException {\r
- this.put3(\r
- resourceType,\r
- resourceInterface,\r
- ocRepresentation,\r
- queryParamsMap,\r
- onPutListener,\r
- qualityOfService.getValue());\r
- }\r
-\r
- private native void put3(String resourceType,\r
- String resourceInterface,\r
- OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPutListener onPutListener,\r
- int qualityOfService) throws OcException;\r
-\r
- /**\r
- * Method to POST on a resource\r
- *\r
- * @param ocRepresentation representation of the resource\r
- * @param queryParamsMap Map which can have the query parameter name and value\r
- * @param onPostListener event handler The event handler will be invoked with a map of\r
- * attribute name and values.\r
- * @throws OcException\r
- */\r
- public native void post(OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPostListener onPostListener) throws OcException;\r
-\r
- /**\r
- * Method to POST on a resource\r
- *\r
- * @param ocRepresentation representation of the resource\r
- * @param queryParamsMap Map which can have the query parameter name and value\r
- * @param onPostListener event handler The event handler will be invoked with a map of\r
- * attribute name and values.\r
- * @param qualityOfService the quality of communication\r
- * @throws OcException\r
- */\r
- public void post(OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPostListener onPostListener,\r
- QualityOfService qualityOfService) throws OcException {\r
- this.post1(\r
- ocRepresentation,\r
- queryParamsMap,\r
- onPostListener,\r
- qualityOfService.getValue());\r
- }\r
-\r
- private native void post1(OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPostListener onPostListener,\r
- int qualityOfService) throws OcException;\r
-\r
- /**\r
- * Method to POST on a resource\r
- *\r
- * @param resourceType resource type of the resource to operate on\r
- * @param resourceInterface interface type of the resource to operate on\r
- * @param ocRepresentation representation of the resource\r
- * @param queryParamsMap Map which can have the query parameter name and value\r
- * @param onPostListener event handler The event handler will be invoked with a map of\r
- * attribute name and values.\r
- * @throws OcException\r
- */\r
- public void post(String resourceType,\r
- String resourceInterface,\r
- OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPostListener onPostListener) throws OcException {\r
- this.post2(\r
- resourceType,\r
- resourceInterface,\r
- ocRepresentation,\r
- queryParamsMap,\r
- onPostListener);\r
- }\r
-\r
- private native void post2(String resourceType,\r
- String resourceInterface,\r
- OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPostListener onPostListener) throws OcException;\r
-\r
- /**\r
- * Method to POST on a resource\r
- *\r
- * @param resourceType resource type of the resource to operate on\r
- * @param resourceInterface interface type of the resource to operate on\r
- * @param ocRepresentation representation of the resource\r
- * @param queryParamsMap Map which can have the query parameter name and value\r
- * @param onPostListener event handler The event handler will be invoked with a map of\r
- * attribute name and values.\r
- * @param qualityOfService the quality of communication\r
- * @throws OcException\r
- */\r
- public void post(String resourceType,\r
- String resourceInterface,\r
- OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPostListener onPostListener,\r
- QualityOfService qualityOfService) throws OcException {\r
- this.post3(\r
- resourceType,\r
- resourceInterface,\r
- ocRepresentation,\r
- queryParamsMap,\r
- onPostListener,\r
- qualityOfService.getValue());\r
- }\r
-\r
- private native void post3(String resourceType,\r
- String resourceInterface,\r
- OcRepresentation ocRepresentation,\r
- Map<String, String> queryParamsMap,\r
- OnPostListener onPostListener,\r
- int qualityOfService) throws OcException;\r
-\r
- /**\r
- * Method to perform DELETE operation\r
- *\r
- * @param onDeleteListener event handler The event handler will have headerOptionList\r
- */\r
- public native void deleteResource(OnDeleteListener onDeleteListener) throws OcException;\r
-\r
- /**\r
- * Method to perform DELETE operation\r
- *\r
- * @param onDeleteListener event handler The event handler will have headerOptionList\r
- * @param qualityOfService the quality of communication\r
- */\r
- public void deleteResource(OnDeleteListener onDeleteListener,\r
- QualityOfService qualityOfService) throws OcException {\r
- this.deleteResource1(onDeleteListener,\r
- qualityOfService.getValue());\r
- }\r
-\r
- private native void deleteResource1(OnDeleteListener onDeleteListener,\r
- int qualityOfService) throws OcException;\r
-\r
- /**\r
- * Method to set observation on the resource\r
- *\r
- * @param observeType allows the client to specify how it wants to observe\r
- * @param queryParamsMap map which can have the query parameter name and value\r
- * @param onObserveListener event handler The handler method will be invoked with a map\r
- * of attribute name and values.\r
- * @throws OcException\r
- */\r
- public void observe(ObserveType observeType,\r
- Map<String, String> queryParamsMap,\r
- OnObserveListener onObserveListener) throws OcException {\r
- this.observe(\r
- observeType.getValue(),\r
- queryParamsMap,\r
- onObserveListener);\r
- }\r
-\r
- private synchronized native void observe(int observeType,\r
- Map<String, String> queryParamsMap,\r
- OnObserveListener onObserveListener) throws OcException;\r
-\r
- /**\r
- * Method to set observation on the resource\r
- *\r
- * @param observeType allows the client to specify how it wants to observe\r
- * @param queryParamsMap map which can have the query parameter name and value\r
- * @param onObserveListener event handler The handler method will be invoked with a map\r
- * of attribute name and values.\r
- * @param qualityOfService the quality of communication\r
- * @throws OcException\r
- */\r
- public void observe(ObserveType observeType,\r
- Map<String, String> queryParamsMap,\r
- OnObserveListener onObserveListener,\r
- QualityOfService qualityOfService) throws OcException {\r
- this.observe1(\r
- observeType.getValue(),\r
- queryParamsMap,\r
- onObserveListener,\r
- qualityOfService.getValue());\r
- }\r
-\r
- private synchronized native void observe1(int observeType,\r
- Map<String, String> queryParamsMap,\r
- OnObserveListener onObserveListener,\r
- int qualityOfService) throws OcException;\r
-\r
- /**\r
- * Method to cancel the observation on the resource\r
- *\r
- * @throws OcException\r
- */\r
- public native void cancelObserve() throws OcException;\r
-\r
- /**\r
- * Method to cancel the observation on the resource\r
- *\r
- * @param qualityOfService the quality of communication\r
- * @throws OcException\r
- */\r
- public void cancelObserve(QualityOfService qualityOfService) throws OcException {\r
- this.cancelObserve1(qualityOfService.getValue());\r
- }\r
-\r
- private native void cancelObserve1(int qualityOfService) throws OcException;\r
-\r
- /**\r
- * Method to set header options\r
- *\r
- * @param headerOptionList List<OcHeaderOption> where header information(header optionID and\r
- * optionData is passed\r
- */\r
- public void setHeaderOptions(List<OcHeaderOption> headerOptionList) {\r
- this.setHeaderOptions(headerOptionList.toArray(\r
- new OcHeaderOption[headerOptionList.size()])\r
- );\r
- }\r
-\r
- private native void setHeaderOptions(OcHeaderOption[] headerOptionList);\r
-\r
- /**\r
- * Method to unset header options\r
- */\r
- public native void unsetHeaderOptions();\r
-\r
- /**\r
- * Method to get the host address of this resource\r
- *\r
- * @return host address NOTE: This might or might not be exposed in future due to\r
- * security concerns\r
- */\r
- public native String getHost();\r
-\r
- /**\r
- * Method to get the URI for this resource\r
- *\r
- * @return resource URI\r
- */\r
- public native String getUri();\r
-\r
- /**\r
- * Method to get the connectivity type of this resource\r
- *\r
- * @return OcConnectivityType connectivity type\r
- */\r
- public OcConnectivityType getConnectivityType() {\r
- return OcConnectivityType.get(\r
- this.getConnectivityTypeN()\r
- );\r
- }\r
-\r
- private native int getConnectivityTypeN();\r
-\r
- /**\r
- * Method to provide ability to check if this resource is observable or not\r
- *\r
- * @return true indicates resource is observable; false indicates resource is not observable\r
- */\r
- public native boolean isObservable();\r
-\r
- /**\r
- * Method to get the list of resource types\r
- *\r
- * @return List of resource types\r
- */\r
- public native List<String> getResourceTypes();\r
-\r
- /**\r
- * Method to get the list of resource interfaces\r
- *\r
- * @return List of resource interface\r
- */\r
- public native List<String> getResourceInterfaces();\r
-\r
- /**\r
- * Method to get a unique identifier for this resource across network interfaces. This will\r
- * be guaranteed unique for every resource-per-server independent of how this was discovered.\r
- *\r
- * @return OcResourceIdentifier object, which can be used for all comparison and hashing\r
- */\r
- public native OcResourceIdentifier getUniqueIdentifier();\r
-\r
- /**\r
- * Method to get a string representation of the resource's server ID.\r
- * * This is unique per- server independent on how it was discovered.\r
- *\r
- * @return server ID\r
- */\r
- public native String getServerId();\r
-\r
- /**\r
- * An OnGetListener can be registered via the resource get call.\r
- * Event listeners are notified asynchronously\r
- */\r
- public interface OnGetListener {\r
- public void onGetCompleted(List<OcHeaderOption> headerOptionList,\r
- OcRepresentation ocRepresentation);\r
-\r
- public void onGetFailed(Throwable ex);\r
- }\r
-\r
- /**\r
- * An OnPutListener can be registered via the resource put call.\r
- * Event listeners are notified asynchronously\r
- */\r
- public interface OnPutListener {\r
- public void onPutCompleted(List<OcHeaderOption> headerOptionList,\r
- OcRepresentation ocRepresentation);\r
-\r
- public void onPutFailed(Throwable ex);\r
- }\r
-\r
- /**\r
- * An OnPostListener can be registered via the resource post call.\r
- * Event listeners are notified asynchronously\r
- */\r
- public interface OnPostListener {\r
- public void onPostCompleted(List<OcHeaderOption> headerOptionList,\r
- OcRepresentation ocRepresentation);\r
-\r
- public void onPostFailed(Throwable ex);\r
- }\r
-\r
- /**\r
- * An OnDeleteListener can be registered via the resource delete call.\r
- * Event listeners are notified asynchronously\r
- */\r
- public interface OnDeleteListener {\r
- public void onDeleteCompleted(List<OcHeaderOption> headerOptionList);\r
-\r
- public void onDeleteFailed(Throwable ex);\r
- }\r
-\r
- /**\r
- * An OnObserveListener can be registered via the resource observe call.\r
- * Event listeners are notified asynchronously\r
- */\r
- public interface OnObserveListener {\r
- public void onObserveCompleted(List<OcHeaderOption> headerOptionList,\r
- OcRepresentation ocRepresentation,\r
- int sequenceNumber);\r
-\r
- public void onObserveFailed(Throwable ex);\r
- }\r
-\r
- @Override\r
- protected void finalize() throws Throwable {\r
- super.finalize();\r
-\r
- dispose();\r
- }\r
-\r
- private native void dispose();\r
-\r
- private long mNativeHandle;\r
-}\r
+/*
+ * //******************************************************************
+ * //
+ * // Copyright 2015 Intel Corporation.
+ * //
+ * //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+ * //
+ * // Licensed under the Apache License, Version 2.0 (the "License");
+ * // you may not use this file except in compliance with the License.
+ * // You may obtain a copy of the License at
+ * //
+ * // http://www.apache.org/licenses/LICENSE-2.0
+ * //
+ * // Unless required by applicable law or agreed to in writing, software
+ * // distributed under the License is distributed on an "AS IS" BASIS,
+ * // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * // See the License for the specific language governing permissions and
+ * // limitations under the License.
+ * //
+ * //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+ */
+
+package org.iotivity.base;
+
+import java.util.EnumSet;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * OcResource represents an OC resource. A resource could be a light controller, temperature sensor,
+ * smoke detector, etc. A resource comes with a well-defined contract or interface onto which you
+ * can perform different operations, such as turning on the light, getting the current temperature
+ * or subscribing for event notifications from the smoke detector. A resource can be composed of
+ * one or more resources.
+ */
+public class OcResource {
+
+ private OcResource(long nativeHandle) {
+ this.mNativeHandle = nativeHandle;
+ }
+
+ /**
+ * Method to get the attributes of a resource.
+ *
+ * @param queryParamsMap map which can have the query parameter name and value
+ * @param onGetListener The event handler will be invoked with a map of attribute name and
+ * values. The event handler will also have the result from this Get
+ * operation This will have error codes
+ * @throws OcException
+ */
+ public native void get(Map<String, String> queryParamsMap,
+ OnGetListener onGetListener) throws OcException;
+
+ /**
+ * Method to get the attributes of a resource.
+ *
+ * @param queryParamsMap map which can have the query parameter name and value
+ * @param onGetListener The event handler will be invoked with a map of attribute name and
+ * values. The event handler will also have the result from this Get
+ * operation This will have error codes
+ * @param qualityOfService the quality of communication
+ * @throws OcException
+ */
+ public void get(Map<String, String> queryParamsMap,
+ OnGetListener onGetListener,
+ QualityOfService qualityOfService) throws OcException {
+ this.get1(queryParamsMap, onGetListener, qualityOfService.getValue());
+ }
+
+ private native void get1(Map<String, String> queryParamsMap,
+ OnGetListener onGetListener,
+ int qualityOfService) throws OcException;
+
+ /**
+ * Method to get the attributes of a resource.
+ *
+ * @param resourceType resourceType of the resource to operate on
+ * @param resourceInterface interface type of the resource to operate on
+ * @param queryParamsMap map which can have the query parameter name and value
+ * @param onGetListener The event handler will be invoked with a map of attribute name and
+ * values. The event handler will also have the result from this Get
+ * operation This will have error codes
+ * @throws OcException
+ */
+ public void get(String resourceType,
+ String resourceInterface,
+ Map<String, String> queryParamsMap,
+ OnGetListener onGetListener) throws OcException {
+ this.get2(
+ resourceType,
+ resourceInterface,
+ queryParamsMap,
+ onGetListener);
+ }
+
+ private native void get2(String resourceType,
+ String resourceInterface,
+ Map<String, String> queryParamsMap,
+ OnGetListener onGetListener) throws OcException;
+
+ /**
+ * Method to get the attributes of a resource.
+ *
+ * @param resourceType resourceType of the resource to operate on
+ * @param resourceInterface interface type of the resource to operate on
+ * @param queryParamsMap map which can have the query parameter name and value
+ * @param onGetListener The event handler will be invoked with a map of attribute name and
+ * values. The event handler will also have the result from this Get
+ * operation This will have error codes
+ * @param qualityOfService the quality of communication
+ * @throws OcException
+ */
+ public void get(String resourceType,
+ String resourceInterface,
+ Map<String, String> queryParamsMap,
+ OnGetListener onGetListener,
+ QualityOfService qualityOfService) throws OcException {
+ this.get3(
+ resourceType,
+ resourceInterface,
+ queryParamsMap,
+ onGetListener,
+ qualityOfService.getValue());
+ }
+
+ private native void get3(String resourceType,
+ String resourceInterface,
+ Map<String, String> queryParamsMap,
+ OnGetListener onGetListener,
+ int qualityOfService) throws OcException;
+
+ /**
+ * Method to set the representation of a resource (via PUT)
+ *
+ * @param representation representation of the resource
+ * @param queryParamsMap Map which can have the query parameter name and value
+ * @param onPutListener event handler The event handler will be invoked with a map of attribute
+ * name and values.
+ * @throws OcException
+ */
+ public native void put(OcRepresentation representation,
+ Map<String, String> queryParamsMap,
+ OnPutListener onPutListener) throws OcException;
+
+ /**
+ * Method to set the representation of a resource (via PUT)
+ *
+ * @param ocRepresentation representation of the resource
+ * @param queryParamsMap Map which can have the query parameter name and value
+ * @param onPutListener event handler The event handler will be invoked with a map of
+ * attribute name and values.
+ * @param qualityOfService the quality of communication
+ * @throws OcException
+ */
+ public void put(OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPutListener onPutListener,
+ QualityOfService qualityOfService) throws OcException {
+ this.put1(
+ ocRepresentation,
+ queryParamsMap,
+ onPutListener,
+ qualityOfService.getValue());
+ }
+
+ private native void put1(OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPutListener onPutListener,
+ int qualityOfService) throws OcException;
+
+ /**
+ * Method to set the representation of a resource (via PUT)
+ *
+ * @param resourceType resource type of the resource to operate on
+ * @param resourceInterface interface type of the resource to operate on
+ * @param ocRepresentation representation of the resource
+ * @param queryParamsMap Map which can have the query parameter name and value
+ * @param onPutListener event handler The event handler will be invoked with a map of
+ * attribute name and values.
+ * @throws OcException
+ */
+ public void put(String resourceType,
+ String resourceInterface,
+ OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPutListener onPutListener) throws OcException {
+ this.put2(
+ resourceType,
+ resourceInterface,
+ ocRepresentation,
+ queryParamsMap,
+ onPutListener);
+ }
+
+ private native void put2(String resourceType,
+ String resourceInterface,
+ OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPutListener onPutListener) throws OcException;
+
+ /**
+ * Method to set the representation of a resource (via PUT)
+ *
+ * @param resourceType resource type of the resource to operate on
+ * @param resourceInterface interface type of the resource to operate on
+ * @param ocRepresentation representation of the resource
+ * @param queryParamsMap Map which can have the query parameter name and value
+ * @param onPutListener event handler The event handler will be invoked with a map of
+ * attribute name and values.
+ * @param qualityOfService the quality of communication
+ * @throws OcException
+ */
+ public void put(String resourceType,
+ String resourceInterface,
+ OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPutListener onPutListener,
+ QualityOfService qualityOfService) throws OcException {
+ this.put3(
+ resourceType,
+ resourceInterface,
+ ocRepresentation,
+ queryParamsMap,
+ onPutListener,
+ qualityOfService.getValue());
+ }
+
+ private native void put3(String resourceType,
+ String resourceInterface,
+ OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPutListener onPutListener,
+ int qualityOfService) throws OcException;
+
+ /**
+ * Method to POST on a resource
+ *
+ * @param ocRepresentation representation of the resource
+ * @param queryParamsMap Map which can have the query parameter name and value
+ * @param onPostListener event handler The event handler will be invoked with a map of
+ * attribute name and values.
+ * @throws OcException
+ */
+ public native void post(OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPostListener onPostListener) throws OcException;
+
+ /**
+ * Method to POST on a resource
+ *
+ * @param ocRepresentation representation of the resource
+ * @param queryParamsMap Map which can have the query parameter name and value
+ * @param onPostListener event handler The event handler will be invoked with a map of
+ * attribute name and values.
+ * @param qualityOfService the quality of communication
+ * @throws OcException
+ */
+ public void post(OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPostListener onPostListener,
+ QualityOfService qualityOfService) throws OcException {
+ this.post1(
+ ocRepresentation,
+ queryParamsMap,
+ onPostListener,
+ qualityOfService.getValue());
+ }
+
+ private native void post1(OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPostListener onPostListener,
+ int qualityOfService) throws OcException;
+
+ /**
+ * Method to POST on a resource
+ *
+ * @param resourceType resource type of the resource to operate on
+ * @param resourceInterface interface type of the resource to operate on
+ * @param ocRepresentation representation of the resource
+ * @param queryParamsMap Map which can have the query parameter name and value
+ * @param onPostListener event handler The event handler will be invoked with a map of
+ * attribute name and values.
+ * @throws OcException
+ */
+ public void post(String resourceType,
+ String resourceInterface,
+ OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPostListener onPostListener) throws OcException {
+ this.post2(
+ resourceType,
+ resourceInterface,
+ ocRepresentation,
+ queryParamsMap,
+ onPostListener);
+ }
+
+ private native void post2(String resourceType,
+ String resourceInterface,
+ OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPostListener onPostListener) throws OcException;
+
+ /**
+ * Method to POST on a resource
+ *
+ * @param resourceType resource type of the resource to operate on
+ * @param resourceInterface interface type of the resource to operate on
+ * @param ocRepresentation representation of the resource
+ * @param queryParamsMap Map which can have the query parameter name and value
+ * @param onPostListener event handler The event handler will be invoked with a map of
+ * attribute name and values.
+ * @param qualityOfService the quality of communication
+ * @throws OcException
+ */
+ public void post(String resourceType,
+ String resourceInterface,
+ OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPostListener onPostListener,
+ QualityOfService qualityOfService) throws OcException {
+ this.post3(
+ resourceType,
+ resourceInterface,
+ ocRepresentation,
+ queryParamsMap,
+ onPostListener,
+ qualityOfService.getValue());
+ }
+
+ private native void post3(String resourceType,
+ String resourceInterface,
+ OcRepresentation ocRepresentation,
+ Map<String, String> queryParamsMap,
+ OnPostListener onPostListener,
+ int qualityOfService) throws OcException;
+
+ /**
+ * Method to perform DELETE operation
+ *
+ * @param onDeleteListener event handler The event handler will have headerOptionList
+ */
+ public native void deleteResource(OnDeleteListener onDeleteListener) throws OcException;
+
+ /**
+ * Method to perform DELETE operation
+ *
+ * @param onDeleteListener event handler The event handler will have headerOptionList
+ * @param qualityOfService the quality of communication
+ */
+ public void deleteResource(OnDeleteListener onDeleteListener,
+ QualityOfService qualityOfService) throws OcException {
+ this.deleteResource1(onDeleteListener,
+ qualityOfService.getValue());
+ }
+
+ private native void deleteResource1(OnDeleteListener onDeleteListener,
+ int qualityOfService) throws OcException;
+
+ /**
+ * Method to set observation on the resource
+ *
+ * @param observeType allows the client to specify how it wants to observe
+ * @param queryParamsMap map which can have the query parameter name and value
+ * @param onObserveListener event handler The handler method will be invoked with a map
+ * of attribute name and values.
+ * @throws OcException
+ */
+ public void observe(ObserveType observeType,
+ Map<String, String> queryParamsMap,
+ OnObserveListener onObserveListener) throws OcException {
+ this.observe(
+ observeType.getValue(),
+ queryParamsMap,
+ onObserveListener);
+ }
+
+ private synchronized native void observe(int observeType,
+ Map<String, String> queryParamsMap,
+ OnObserveListener onObserveListener) throws OcException;
+
+ /**
+ * Method to set observation on the resource
+ *
+ * @param observeType allows the client to specify how it wants to observe
+ * @param queryParamsMap map which can have the query parameter name and value
+ * @param onObserveListener event handler The handler method will be invoked with a map
+ * of attribute name and values.
+ * @param qualityOfService the quality of communication
+ * @throws OcException
+ */
+ public void observe(ObserveType observeType,
+ Map<String, String> queryParamsMap,
+ OnObserveListener onObserveListener,
+ QualityOfService qualityOfService) throws OcException {
+ this.observe1(
+ observeType.getValue(),
+ queryParamsMap,
+ onObserveListener,
+ qualityOfService.getValue());
+ }
+
+ private synchronized native void observe1(int observeType,
+ Map<String, String> queryParamsMap,
+ OnObserveListener onObserveListener,
+ int qualityOfService) throws OcException;
+
+ /**
+ * Method to cancel the observation on the resource
+ *
+ * @throws OcException
+ */
+ public native void cancelObserve() throws OcException;
+
+ /**
+ * Method to cancel the observation on the resource
+ *
+ * @param qualityOfService the quality of communication
+ * @throws OcException
+ */
+ public void cancelObserve(QualityOfService qualityOfService) throws OcException {
+ this.cancelObserve1(qualityOfService.getValue());
+ }
+
+ private native void cancelObserve1(int qualityOfService) throws OcException;
+
+ /**
+ * Method to set header options
+ *
+ * @param headerOptionList List<OcHeaderOption> where header information(header optionID and
+ * optionData is passed
+ */
+ public void setHeaderOptions(List<OcHeaderOption> headerOptionList) {
+ this.setHeaderOptions(headerOptionList.toArray(
+ new OcHeaderOption[headerOptionList.size()])
+ );
+ }
+
+ private native void setHeaderOptions(OcHeaderOption[] headerOptionList);
+
+ /**
+ * Method to unset header options
+ */
+ public native void unsetHeaderOptions();
+
+ /**
+ * Method to get the host address of this resource
+ *
+ * @return host address NOTE: This might or might not be exposed in future due to
+ * security concerns
+ */
+ public native String getHost();
+
+ /**
+ * Method to get the URI for this resource
+ *
+ * @return resource URI
+ */
+ public native String getUri();
+
+ /**
+ * Method to get the connectivity type of this resource
+ *
+ * @return EnumSet<OcConnectivityType></OcConnectivityType> connectivity type set
+ */
+ public EnumSet<OcConnectivityType> getConnectivityTypeSet() {
+ return OcConnectivityType.convertToEnumSet(
+ this.getConnectivityTypeN()
+ );
+ }
+
+ private native int getConnectivityTypeN();
+
+ /**
+ * Method to provide ability to check if this resource is observable or not
+ *
+ * @return true indicates resource is observable; false indicates resource is not observable
+ */
+ public native boolean isObservable();
+
+ /**
+ * Method to get the list of resource types
+ *
+ * @return List of resource types
+ */
+ public native List<String> getResourceTypes();
+
+ /**
+ * Method to get the list of resource interfaces
+ *
+ * @return List of resource interface
+ */
+ public native List<String> getResourceInterfaces();
+
+ /**
+ * Method to get a unique identifier for this resource across network interfaces. This will
+ * be guaranteed unique for every resource-per-server independent of how this was discovered.
+ *
+ * @return OcResourceIdentifier object, which can be used for all comparison and hashing
+ */
+ public native OcResourceIdentifier getUniqueIdentifier();
+
+ /**
+ * Method to get a string representation of the resource's server ID.
+ * * This is unique per- server independent on how it was discovered.
+ *
+ * @return server ID
+ */
+ public native String getServerId();
+
+ /**
+ * An OnGetListener can be registered via the resource get call.
+ * Event listeners are notified asynchronously
+ */
+ public interface OnGetListener {
+ public void onGetCompleted(List<OcHeaderOption> headerOptionList,
+ OcRepresentation ocRepresentation);
+
+ public void onGetFailed(Throwable ex);
+ }
+
+ /**
+ * An OnPutListener can be registered via the resource put call.
+ * Event listeners are notified asynchronously
+ */
+ public interface OnPutListener {
+ public void onPutCompleted(List<OcHeaderOption> headerOptionList,
+ OcRepresentation ocRepresentation);
+
+ public void onPutFailed(Throwable ex);
+ }
+
+ /**
+ * An OnPostListener can be registered via the resource post call.
+ * Event listeners are notified asynchronously
+ */
+ public interface OnPostListener {
+ public void onPostCompleted(List<OcHeaderOption> headerOptionList,
+ OcRepresentation ocRepresentation);
+
+ public void onPostFailed(Throwable ex);
+ }
+
+ /**
+ * An OnDeleteListener can be registered via the resource delete call.
+ * Event listeners are notified asynchronously
+ */
+ public interface OnDeleteListener {
+ public void onDeleteCompleted(List<OcHeaderOption> headerOptionList);
+
+ public void onDeleteFailed(Throwable ex);
+ }
+
+ /**
+ * An OnObserveListener can be registered via the resource observe call.
+ * Event listeners are notified asynchronously
+ */
+ public interface OnObserveListener {
+ public void onObserveCompleted(List<OcHeaderOption> headerOptionList,
+ OcRepresentation ocRepresentation,
+ int sequenceNumber);
+
+ public void onObserveFailed(Throwable ex);
+ }
+
+ @Override
+ protected void finalize() throws Throwable {
+ super.finalize();
+
+ dispose();
+ }
+
+ private native void dispose();
+
+ private long mNativeHandle;
+}
projects / platform / upstream / iotivity.git / blobdiff