Package getAnnotationsByType(Class) in Java

getAnnotationsByType(Class): This method is available in the java.lang.Package class of Java.

Syntax:

<Annotation> Annotation[] java.lang.Package.getAnnotationsByType(Class<Annotation> annotationClass)

This method takes one argument. This method returns annotations that are associated with this element.

If there are no annotations associated with this element, the return value is an array of length 0.

Note that any annotations returned by this method are declaration annotations.

Type Parameters: <A> the type of the annotation to query for and return if present.

Parameters: One parameter is required for this method.

annotationClass: the Class object corresponding to the annotation type.

Returns: all this element's annotations for the specified annotation type if associated with this element, else an array of length zero.

Throws:

1. NullPointerException - if the given annotation class is null.

Approach 1: When no exception

Java

package com.Package;

import java.util.Arrays;

public class PackagegetAnnotationsByType {

    public static void main(String[] args) 
                         throws ClassNotFoundException {

        Class<?> class1 = Class.forName("java.lang.String");

        Package package1 = class1.getPackage();

        System.out.println(Arrays.toString(package1.getAnnotationsByType(Deprecated.class)));
    }
}

Output:

[]

Approach 2: NullPointerException

Java

package com.Package;

import java.util.Arrays;

public class PackagegetAnnotationsByType {

    public static void main(String[] args) 
                             throws ClassNotFoundException {

        Class<?> class1 = Class.forName("java.lang.String");

        Package package1 = class1.getPackage();

        System.out.println(Arrays.toString(package1.getAnnotationsByType(null)));
    }
}

Output:

Exception in thread "main" java.lang.NullPointerException
	at java.base/java.util.Objects.requireNonNull(Objects.java:208)
	at java.base/java.lang.Class.getAnnotationsByType(Class.java:3890)
	at java.base/java.lang.Package.getAnnotationsByType(Package.java:469)
	at com.Package.PackagegetAnnotationsByType.main(PackagegetAnnotationsByType.java:13)

Some other methods of Package

getAnnotation(Class): This method returns this element's annotation for the specified type if such an annotation is present, else null.

getAnnotations(): This method returns annotations that are present on this element.

getAnnotationsByType(Class): This method returns annotations that are associated with this element.

getDeclaredAnnotation(Class): This method returns this element's annotation for the specified type if such an annotation is directly present, else null. This method ignores inherited annotations.

getDeclaredAnnotations(): This method returns annotations that are directly present on this element. This method ignores inherited annotations.

getDeclaredAnnotationsByType(Class): This method returns this element's annotation(s) for the specified type if such annotations are either directly present or indirectly present.

getImplementationTitle(): This method returns the title of this package.

getImplementationVendor(): This method returns the vendor that implemented this package, null is returned if it is not known.

getImplementationVersion(): This method returns the version of this implementation.

getName(): This method returns the name of this package.

getPackages(): This method returns all of the Packages defined by the caller's class loader and its ancestors.

getSpecificationTitle(): This method returns the title of the specification that this package implements.

getSpecificationVendor(): This method returns the name of the organization, vendor, or company that owns and maintains the specification of the classes that implement this package.

getSpecificationVersion(): This method returns the version number of the specification that this package implements.

hashCode(): This method returns the hash code computed from the package name.

isAnnotationPresent(Class): This method returns true if an annotation for the specified type is present on this element, else false.

isCompatibleWith(String): This method compares this package's specification version with the desired version.

isSealed(): This method returns true if this package is sealed.

isSealed(URL): This method returns true if this package is sealed with respect to the specified code source URL.

toString(): This method returns the string representation of this Package.