jahia-java-osgi

To implement OSGi components correctly in a Jahia Java module, follow documented patterns for SCR activation, configuration reloads, and service references using @Component, @Reference, and @Activate annotations to enforce lifecycle correctness and safe reference handling.

A Jahia OSGi component throws a NullPointerException during activation due to improper @Reference handling or unsafe service binding. Enforcing correct OSGi lifecycle patterns and safe reference handling prevents these NPEs and avoids leaked internals.

The best way to handle configuration reloads in Jahia OSGi services is by applying documented practices for @Activate lifecycle management, ensuring clear configuration reload patterns that prevent stale state and maintain thread safety.

To ensure thread safety when using OSGi whiteboard services in Jahia, apply correct OSGi patterns for service references and component lifecycle management, which mitigate stale state and ensure reliable concurrent execution.

You need to specify Export-Package when building Jahia Java modules to correctly expose your OSGi services. Proper usage of Export-Package alongside whiteboard services and @Component patterns prevents leaked internals.

You should review Jahia Java classes annotated with @Component, @Reference, or @Activate whenever you need to validate lifecycle correctness, ensure thread safety, and identify pitfalls that lead to stale state or leaked internals during module development.