org.glassfish.hk2.bootstrap
Interface PopulatorPostProcessor

All Known Implementing Classes:

Hk2LoaderPopulatorPostProcessor

public interface PopulatorPostProcessor

Author:

jwells, mason.taube@oracle.com

Method Summary

List<DescriptorImpl>

process(DescriptorImpl descriptorImpl) This method can be used to alter the descriptor read in.

Method Detail

process

List<DescriptorImpl> process(DescriptorImpl descriptorImpl)

This method can be used to alter the descriptor read in. It can also add descriptors, or remove the descriptor (by returning an empty list). If this method returns null, then the passed in descriptor will be used. Any alterations made to this descriptor in that case will remain in effect. If this method returns a list the descriptors from the list will be added to the service locator, and not the incoming descriptorImpl. However, the incoming descriptorImpl may be a member of the list.

Parameters:

descriptorImpl - The descriptorImpl read from some external source. This processor can modify this descriptor fully.

Returns:

A list of descriptors to be added to the system. If this returns non-null only the descriptors from this list will be added to the system (hence returning an empty list effectively drops the incoming descriptor). If this returns null then the incoming descriptor will be added to the system.