opendaylight/networkconfiguration/neutron/src/main/java/org/opendaylight/controller/networkconfig/neutron/INeutronPortAware.java

   1 /*
   2  * Copyright IBM Corporation, 2013.  All rights reserved.
   3  *
   4  * This program and the accompanying materials are made available under the
   5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
   6  * and is available at http://www.eclipse.org/legal/epl-v10.html
   7  */
   8
   9 package org.opendaylight.controller.networkconfig.neutron;
  10
  11 /**
  12  * This interface defines the methods a service that wishes to be aware of Neutron Ports needs to implement
  13  *
  14  */
  15
  16 public interface INeutronPortAware {
  17
  18     /**
  19      * Services provide this interface method to indicate if the specified port can be created
  20      *
  21      * @param port
  22      *            instance of proposed new Neutron Port object
  23      * @return integer
  24      *            the return value is understood to be a HTTP status code.  A return value outside of 200 through 299
  25      *            results in the create operation being interrupted and the returned status value reflected in the
  26      *            HTTP response.
  27      */
  28     public int canCreatePort(NeutronPort port);
  29
  30     /**
  31      * Services provide this interface method for taking action after a port has been created
  32      *
  33      * @param port
  34      *            instance of new Neutron Port object
  35      * @return void
  36      */
  37     public void neutronPortCreated(NeutronPort port);
  38
  39     /**
  40      * Services provide this interface method to indicate if the specified port can be changed using the specified
  41      * delta
  42      *
  43      * @param delta
  44      *            updates to the port object using patch semantics
  45      * @param port
  46      *            instance of the Neutron Port object to be updated
  47      * @return integer
  48      *            the return value is understood to be a HTTP status code.  A return value outside of 200 through 299
  49      *            results in the update operation being interrupted and the returned status value reflected in the
  50      *            HTTP response.
  51      */
  52     public int canUpdatePort(NeutronPort delta, NeutronPort original);
  53
  54     /**
  55      * Services provide this interface method for taking action after a port has been updated
  56      *
  57      * @param port
  58      *            instance of modified Neutron Port object
  59      * @return void
  60      */
  61     public void neutronPortUpdated(NeutronPort port);
  62
  63     /**
  64      * Services provide this interface method to indicate if the specified port can be deleted
  65      *
  66      * @param port
  67      *            instance of the Neutron Port object to be deleted
  68      * @return integer
  69      *            the return value is understood to be a HTTP status code.  A return value outside of 200 through 299
  70      *            results in the delete operation being interrupted and the returned status value reflected in the
  71      *            HTTP response.
  72      */
  73     public int canDeletePort(NeutronPort port);
  74
  75     /**
  76      * Services provide this interface method for taking action after a port has been deleted
  77      *
  78      * @param port
  79      *            instance of deleted Port Network object
  80      * @return void
  81      */
  82     public void neutronPortDeleted(NeutronPort port);
  83 }