org.glassfish.javaee.full.deployment

Class EarDetector

java.lang.Object

org.glassfish.javaee.full.deployment.EarDetector

All Implemented Interfaces:

ArchiveDetector

@Service(name="ear")
 @Singleton
public class EarDetector
extends Object
implements ArchiveDetector

Detects ear type archives. It's rank can be set using system property EAR_DETECTOR_RANK_PROP. Default rank is DEFAULT_EAR_DETECTOR_RANK.

Author:

sanjeeb.sahoo@oracle.com

Field Summary

Fields

Modifier and Type	Field and Description
static String	ARCHIVE_TYPE
static int	DEFAULT_EAR_DETECTOR_RANK
static String	EAR_DETECTOR_RANK_PROP

Constructor Summary

Constructors

Constructor and Description
EarDetector()

Method Summary

Modifier and Type	Method and Description
ArchiveHandler	getArchiveHandler() Return a ArchiveHandler that can handle the archive recognised by this ArchiveDetector.
ArchiveType	getArchiveType() Returns the type of the deployment unit or archive or module whichever way you want to call what's being depoyed.
boolean	handles(ReadableArchive archive) This method is used to detect the archive type.
int	rank() Since archive detection logic is typically executed at a very early stage of deployment, it is mainly heuristic.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EAR_DETECTOR_RANK_PROP

public static final String EAR_DETECTOR_RANK_PROP

See Also:

Constant Field Values

DEFAULT_EAR_DETECTOR_RANK

public static final int DEFAULT_EAR_DETECTOR_RANK

See Also:

Constant Field Values

ARCHIVE_TYPE

public static final String ARCHIVE_TYPE

See Also:

Constant Field Values

Constructor Detail

EarDetector

public EarDetector()

Method Detail

rank

public int rank()

Description copied from interface: ArchiveDetector

Since archive detection logic is typically executed at a very early stage of deployment, it is mainly heuristic. So some detectors can incorrectly recognize archives that they actually don't support. e.g., take a war file inside an ear file. and asssume that the war file contains some .jsp files. The archive detector responsible for handling the war file could be fooled into thinking the ear file is a war file since it contains jsp files, yet in reality, it only owns one of the sub archive bundled inside the composite ear file. To deal with such situations, each detector can specify a rank which can be used to order the detectors. Since detectors can come from separate authors, rank of a detector must be configurable in an installation. The order in which detectors are used during archive detection is based on the rank. Lower the integer value as returned by this method, earlier it is used during detection.

Specified by:

rank in interface ArchiveDetector

Returns:

the rank of this detector

handles

public boolean handles(ReadableArchive archive)
                throws IOException

Description copied from interface: ArchiveDetector

This method is used to detect the archive type. If this detector can recognize the given archive, then it must return true.

Specified by:

handles in interface ArchiveDetector

Returns:

Throws:

IOException

getArchiveHandler

public ArchiveHandler getArchiveHandler()

Description copied from interface: ArchiveDetector

Return a ArchiveHandler that can handle the archive recognised by this ArchiveDetector.

Specified by:

getArchiveHandler in interface ArchiveDetector

Returns:

getArchiveType

public ArchiveType getArchiveType()

Description copied from interface: ArchiveDetector

Returns the type of the deployment unit or archive or module whichever way you want to call what's being depoyed. Each archive handler is responsible for only one type of archive and the type of the archive is represented by ArchiveType.

Specified by:

getArchiveType in interface ArchiveDetector

Returns:

the type of the archive or deployment unit that can be detected by this detector