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

   1 /*
   2  * Copyright (c) 2019 Pantheon Technologies, s.r.o. 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 import com.google.common.annotations.Beta;
  11
  12 /**
  13  * An extension to a concrete {@link ExtensibleObject}. This is a marker interface to introduce type safety and unlike
  14  * full Extensible Objects, does not specify how extensions are attached to an extensible object.
  15  *
  16  * <p>
  17  * {@link ObjectExtension} instances are attached to their host object and share its state, which means they work in
  18  * concert and care must be taken to ensure consistency, such as thread safety and observable effects.
  19  *
  20  * @param <T> Extensible object type
  21  * @param <E> Extension type
  22  * @author Robert Varga
  23  */
  24 @Beta
  25 public interface ObjectExtension<T extends ExtensibleObject<T, E>, E extends ObjectExtension<T, E>> {
  26
  27 }