/*
 * 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.onlab.onos.net.resource;

import java.util.Set;

import org.onlab.onos.net.Link;
import org.onlab.onos.net.intent.IntentId;


/**
 * Manages link resources.
 */
public interface LinkResourceStore {
    Set<ResourceAllocation> getFreeResources(Link link);

    void allocateResources(LinkResourceAllocations allocations);

    void releaseResources(LinkResourceAllocations allocations);

    LinkResourceAllocations getAllocations(IntentId intentId);

    Iterable<LinkResourceAllocations> getAllocations(Link link);

    Iterable<LinkResourceAllocations> getAllocations();
}

@@ -740,17 +740,16 @@
 entId;%0A%0A
-%0A
 /**%0A * M
@@ -820,322 +820,1065 @@
     
-Set%3CResourceAllocation%3E getFreeResources(Link link);%0A%0A    void allocateResources(LinkResourceAllocations allocations);%0A%0A    void releaseResources(LinkResourceAllocations allocations);%0A%0A    LinkResourceAllocations getAllocations(IntentId intentId);%0A%0A    Iterable%3CLinkResourceAllocations%3E getAllocations(Link link);%0A
+/**%0A     * Returns free resources for given link.%0A     *%0A     * @param link a target link%0A     * @return free resources for given link%0A     */%0A    Set%3CResourceAllocation%3E getFreeResources(Link link);%0A%0A    /**%0A     * Allocates resources.%0A     *%0A     * @param allocations resources to be allocated%0A     */%0A    void allocateResources(LinkResourceAllocations allocations);%0A%0A    /**%0A     * Releases resources.%0A     *%0A     * @param allocations resources to be released%0A     */%0A    void releaseResources(LinkResourceAllocations allocations);%0A%0A    /**%0A     * Returns resources allocated for an Intent.%0A     *%0A     * @param intentId the target Intent's ID%0A     * @return allocated resources%0A     */%0A    LinkResourceAllocations getAllocations(IntentId intentId);%0A%0A    /**%0A     * Returns resources allocated for a link.%0A     *%0A     * @param link the target link%0A     * @return allocated resources%0A     */%0A    Iterable%3CLinkResourceAllocations%3E getAllocations(Link link);%0A%0A    /**%0A     * Returns all allocated resources.%0A     *%0A     * @return allocated resources%0A     */
 %0A   

Add javadocs for LinkResourceStore interface.