binding/yang-binding/src/main/java/org/opendaylight/yangtools/yang/binding/OpaqueObject.java

   1 /*
   2  * Copyright (c) 2019 PANTHEON.tech, 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.yang.binding;
   9
  10 import com.google.common.annotations.Beta;
  11
  12 /**
  13  * An opaque object. This interface supports code generation for both {@code anyxml} and {@code anydata}. Both of these
  14  * statements essentially share the same characteristic of storing data whose actual schema and representation is not
  15  * known at compile-time. Schema may be unknown even at runtime, and furthermore the representation may vary during
  16  * run-time, based on source of the data.
  17  *
  18  * <p>
  19  * The code generation is therefore limited to a single interface, which only provides the default implementation
  20  * of {@link #implementedInterface()} bound to itself. The value is communicated through {@link #getValue()}, which
  21  * is only an encapsulation holding information about the object model and the data in that object model.
  22  *
  23  * @param <T> Generated interface
  24  */
  25 @Beta
  26 public interface OpaqueObject<T extends OpaqueObject<T>> extends BindingObject, DataContainer,
  27         ValueAware<OpaqueData<?>> {
  28     @Override
  29     Class<T> implementedInterface();
  30 }