Moving LabelResourceManager to incubator
Breaking apart resource package into {device, link, label}
Refactored cluster serializers so they are visible
Change-Id: I71051bcd5e790ae6abeb154bf58286e584c32858
diff --git a/core/api/src/main/java/org/onosproject/net/resource/link/LinkResourceService.java b/core/api/src/main/java/org/onosproject/net/resource/link/LinkResourceService.java
new file mode 100644
index 0000000..69bdf4f
--- /dev/null
+++ b/core/api/src/main/java/org/onosproject/net/resource/link/LinkResourceService.java
@@ -0,0 +1,107 @@
+/*
+ * Copyright 2014 Open Networking Laboratory
+ *
+ * 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.onosproject.net.resource.link;
+
+import org.onosproject.net.Link;
+import org.onosproject.net.intent.IntentId;
+import org.onosproject.net.resource.ResourceRequest;
+
+/**
+ * Service for providing link resource allocation.
+ */
+public interface LinkResourceService {
+
+ /**
+ * Requests resources.
+ *
+ * @param req resources to be allocated
+ * @return allocated resources
+ */
+ LinkResourceAllocations requestResources(LinkResourceRequest req);
+
+ /**
+ * Releases resources.
+ *
+ * @param allocations resources to be released
+ */
+ void releaseResources(LinkResourceAllocations allocations);
+
+ /**
+ * Updates previously made allocations with a new resource request.
+ *
+ * @param req updated resource request
+ * @param oldAllocations old resource allocations
+ * @return new resource allocations
+ */
+ LinkResourceAllocations updateResources(LinkResourceRequest req,
+ LinkResourceAllocations oldAllocations);
+
+ /**
+ * Returns all allocated resources.
+ *
+ * @return allocated resources
+ */
+ Iterable<LinkResourceAllocations> getAllocations();
+
+ /**
+ * Returns all allocated resources to given link.
+ *
+ * @param link a target link
+ * @return allocated resources
+ */
+ Iterable<LinkResourceAllocations> getAllocations(Link link);
+
+ /**
+ * Returns the resources allocated for an Intent.
+ *
+ * @param intentId the target Intent's id
+ * @return allocated resources for Intent
+ */
+ LinkResourceAllocations getAllocations(IntentId intentId);
+
+ /**
+ * Returns available resources for given link.
+ *
+ * @param link a target link
+ * @return available resources for the target link
+ */
+ Iterable<ResourceRequest> getAvailableResources(Link link);
+
+ /**
+ * Returns available resources for given link.
+ *
+ * @param link a target link
+ * @param allocations allocations to be included as available
+ * @return available resources for the target link
+ */
+ Iterable<ResourceRequest> getAvailableResources(Link link,
+ LinkResourceAllocations allocations);
+
+ /**
+ * Adds a listener for resource related events.
+ *
+ * @param listener listener to add
+ */
+ void addListener(LinkResourceListener listener);
+
+ /**
+ * Removes a listener for resource related events.
+ *
+ * @param listener listener to remove.
+ */
+ void removeListener(LinkResourceListener listener);
+
+}