Access Restriction: Dealing with Non-API Class Restrictions in Eclipse

Eclipse enforces access restrictions to prevent developers from inadvertently using classes outside of their intended public API. However, certain scenarios may necessitate accessing restricted classes.

Cause of Access Restriction Error

The error reported ("Access restriction: The type 'Application' is not API ...") occurs when Eclipse detects the use of a non-API class, such as com.apple.eawt.Application. This class is not explicitly included in the public API of Java.

Solution: Modifying Access Restrictions

To resolve the error and access the restricted class, modify the access restrictions within Eclipse:

1. Right-click on the project folder in the Package Explorer and select Properties.
2. Navigate to Java Build Path > Libraries.
3. Expand the problematic library (e.g., rt.jar for the mentioned case).
4. Select Access Rules.
5. Click Edit....
6. Click Add....
7. Create a Resolution: Accessible rule with the pattern: com/apple/eawt/**

This rule will grant access to all classes within the com.apple.eawt package, including the Application class.

Note:

• Modifying access restrictions should be done cautiously, as accessing non-API classes can lead to potential runtime issues.
• Ensure that the accessed classes are compatible and stable for your use case.
• Alternative solutions may exist, such as finding an alternative public API route or using a third-party library that provides similar functionality.