serp.bytecode.Annotated Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of openjpa-all
There is a newer version: 4.0.0
package serp.bytecode;

/**
 * An annotated entity.
 *
 * @author Abe White
 */
public abstract class Annotated extends Attributes {
    /**
     * Return runtime invisible annotation information for the entity.
     * Acts internally through the {@link Attributes} interface.
     *
     * @param add if true, a new annotations attribute will be added if not 
     * already present
     * @return the annotation information, or null if none and the
     * add param is set to false
     */
    public Annotations getDeclaredAnnotations(boolean add) {
        Annotations ann = (Annotations) getAttribute
            (Constants.ATTR_ANNOTATIONS);
        if (!add || ann != null)
            return ann;
        ensureBytecodeVersion();
        return (Annotations) addAttribute(Constants.ATTR_ANNOTATIONS);
    }

    /**
     * Remove the runtime invisible annotations attribute for the entity.
     * Acts internally through the {@link Attributes} interface.
     *
     * @return true if there was an attribute to remove
     */
    public boolean removeDeclaredAnnotations() {
        return removeAttribute(Constants.ATTR_ANNOTATIONS);
    }

    /**
     * Return runtime visible annotation information for the entity.
     * Acts internally through the {@link Attributes} interface.
     *
     * @param add if true, a new runtime annotations attribute will be
     * added if not already present
     * @return the annotation information, or null if none and the
     * add param is set to false
     */
    public Annotations getDeclaredRuntimeAnnotations(boolean add) {
        Annotations ann = (Annotations) getAttribute
            (Constants.ATTR_RUNTIME_ANNOTATIONS);
        if (!add || ann != null)
            return ann;
        ensureBytecodeVersion();
        return (Annotations) addAttribute(Constants.ATTR_RUNTIME_ANNOTATIONS);
    }

    /**
     * Remove the runtime visible annotations attribute for the entity.
     * Acts internally through the {@link Attributes} interface.
     *
     * @return true if there was an attribute to remove
     */
    public boolean removeDeclaredRuntimeAnnotations() {
        return removeAttribute(Constants.ATTR_RUNTIME_ANNOTATIONS);
    }

    /**
     * When adding annotations, make sure the bytecode spec supports them.
     */
    private void ensureBytecodeVersion() {
        BCClass bc = getBCClass();
        if (bc.getMajorVersion() < Constants.MAJOR_VERSION_JAVA5) {
            bc.setMajorVersion(Constants.MAJOR_VERSION_JAVA5);
            bc.setMinorVersion(Constants.MINOR_VERSION_JAVA5);
        }
    }
 
    /**
     * Internal access to the owning class.
     */
    abstract BCClass getBCClass();
}