common/concepts/src/main/java/org/opendaylight/yangtools/concepts/Builder.java

   1 /*
   2  * Copyright (c) 2013 Cisco Systems, Inc. and others.  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 package org.opendaylight.yangtools.concepts;
   9
  10 /**
  11  * Builder object which produces a product.
  12  *
  13  * @param <P> Product of builder
  14  *
  15  * @author Tony Tkacik &lt;ttkacik@cisco.com&gt;
  16  */
  17 public interface Builder<P> extends Mutable {
  18     /**
  19      * Returns instance of the product. Multiple calls to this method are not required to return same instance if
  20      * the state of the builder has changed.
  21      *
  22      * @return A newly-built instance
  23      * @throws IllegalStateException if the builder's state is not sufficiently initialized
  24      */
  25     P build();
  26 }