com.sun.enterprise.connectors.connector.module

Class RarDetector

java.lang.Object

com.sun.enterprise.connectors.connector.module.RarDetector

All Implemented Interfaces:

ArchiveDetector

@Service(name="rar")
 @Singleton
public class RarDetector
extends Object
implements ArchiveDetector

Detects rar type archives. It's rank can be set using system property RAR_DETECTOR_RANK_PROP. Default rank is DEFAULT_RAR_DETECTOR_RANK.

Author:

sanjeeb.sahoo@oracle.com

Field Summary

Fields

Modifier and Type	Field and Description
static String	ARCHIVE_TYPE
static int	DEFAULT_RAR_DETECTOR_RANK
static String	RAR_DETECTOR_RANK_PROP

Constructor Summary

Constructors

Constructor and Description
RarDetector()

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

RAR_DETECTOR_RANK_PROP

public static final String RAR_DETECTOR_RANK_PROP

See Also:

Constant Field Values

DEFAULT_RAR_DETECTOR_RANK

public static final int DEFAULT_RAR_DETECTOR_RANK

See Also:

Constant Field Values

ARCHIVE_TYPE

public static final String ARCHIVE_TYPE

See Also:

Constant Field Values

Constructor Detail

RarDetector

public RarDetector()

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

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

handles

public boolean handles(ReadableArchive archive)
                throws IOException

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