Package org.apache.tools.ant.taskdefs.rmic

# Class DefaultRmicAdapter

java.lang.Object
org.apache.tools.ant.taskdefs.rmic.DefaultRmicAdapter

All Implemented Interfaces:
  `RmicAdapter`

Direct Known Subclasses:
  `ForkingSunRmic`, `KaffeRmic`, `SunRmic`, `WLRmic`

public abstract class DefaultRmicAdapter extends Object implements RmicAdapter
This is the default implementation for the RmicAdapter interface. Currently, this is a cut-and-paste of the original rmic task and DefaultCompilerAdapter.

Since:
  Ant 1.4

## Field Summary

Fields
Modifier and Type
Field
Description
`static final String`
`RMI_SKEL_SUFFIX`
suffix denoting a skel file: "_Skel"
`static final String`
`RMI_STUB_SUFFIX`
suffix denoting a stub file: "_Stub"
`static final String`
`RMI_TIE_SUFFIX`
suffix denoting a tie file: "_Tie"
`static final String`
`STUB_1_1`
arg for 1.1: "-v1.1"
`static final String`
`STUB_1_2`
arg for 1.2: "-v1.2"
`static final String`
`STUB_COMPAT`
arg for compat: "-vcompat"
`static final String`
`STUB_OPTION_1_1`
option for stub 1.1 in the rmic task: "1.1"
`static final String`
`STUB_OPTION_1_2`
option for stub 1.2 in the rmic task: "1.2"
`static final String`
`STUB_OPTION_COMPAT`
option for stub compat in the rmic task: "compat"

## Constructor Summary

Constructors
Constructor
Description
`DefaultRmicAdapter()`

## Method Summary

Modifier and Type
Method
Description
`protected String`
`addStubVersionOptions()`
This is an override point; get the stub version off the rmic command and translate that into a compiler-specific argument
`protected boolean`
`areIiopAndIdlSupported()`
Whether the iiop and idl switches are supported.
`protected String[]`
`filterJvmCompilerArgs(String[] compilerArgs)`
Strip out all -J args from the command list.
`Path`
`getClasspath()`
Gets the CLASSPATH this rmic process will use.
`protected Path`
`getCompileClasspath()`
Builds the compilation classpath.
`FileNameMapper`
`getMapper()`
This implementation returns a mapper that may return up to two file names.
`Rmic`
`getRmic()`
Get the Rmic attributes
`protected String`
`getSkelClassSuffix()`
Gets the skeleton class suffix
`protected String`
`getStubClassSuffix()`
Gets the stub class suffix
`protected String`
`getTieClassSuffix()`
Gets the tie class suffix
`protected void`
`logAndAddFilesToCompile(Commandline cmd)`
Logs the compilation parameters, adds the files to compile and logs the "niceSourceList"
`protected String[]`
`preprocessCompilerArgs(String[] compilerArgs)`
Preprocess the compiler arguments in any way you see fit.
`void`
`setRmic(Rmic attributes)`
Sets Rmic attributes
`protected Commandline`
`setupRmicCommand()`
Setup rmic argument for rmic.
`protected Commandline`
`setupRmicCommand(String[] options)`
Setup rmic argument for rmic.

### Methods inherited from class java.lang.Object

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

### Methods inherited from interface org.apache.tools.ant.taskdefs.rmic.RmicAdapter

`execute`

## Field Details

### RMI_STUB_SUFFIX

public static final String RMI_STUB_SUFFIX
suffix denoting a stub file: "_Stub"

See Also:
  - Constant Field Values

### RMI_SKEL_SUFFIX

public static final String RMI_SKEL_SUFFIX
suffix denoting a skel file: "_Skel"

See Also:
  - Constant Field Values

### RMI_TIE_SUFFIX

public static final String RMI_TIE_SUFFIX
suffix denoting a tie file: "_Tie"

See Also:
  - Constant Field Values

### STUB_COMPAT

public static final String STUB_COMPAT
arg for compat: "-vcompat"

See Also:
  - Constant Field Values

### STUB_1_1

public static final String STUB_1_1
arg for 1.1: "-v1.1"

See Also:
  - Constant Field Values

### STUB_1_2

public static final String STUB_1_2
arg for 1.2: "-v1.2"

See Also:
  - Constant Field Values

### STUB_OPTION_1_1

public static final String STUB_OPTION_1_1
option for stub 1.1 in the rmic task: "1.1"

See Also:
  - Constant Field Values

### STUB_OPTION_1_2

public static final String STUB_OPTION_1_2
option for stub 1.2 in the rmic task: "1.2"

See Also:
  - Constant Field Values

### STUB_OPTION_COMPAT

public static final String STUB_OPTION_COMPAT
option for stub compat in the rmic task: "compat"

See Also:
  - Constant Field Values

## Constructor Details

### DefaultRmicAdapter

public DefaultRmicAdapter()

## Method Details

### setRmic

public void setRmic(Rmic attributes)
Sets Rmic attributes

Specified by:
  `setRmic` in interface `RmicAdapter`
Parameters:
  `attributes` - the rmic attributes

### getRmic

public Rmic getRmic()
Get the Rmic attributes

Returns:
  the attributes as a Rmic taskdef

### getStubClassSuffix

protected String getStubClassSuffix()
Gets the stub class suffix

Returns:
  the stub suffix "_Stub"

### getSkelClassSuffix

protected String getSkelClassSuffix()
Gets the skeleton class suffix

Returns:
  the skeleton suffix "_Skel"

### getTieClassSuffix

protected String getTieClassSuffix()
Gets the tie class suffix

Returns:
  the tie suffix "_Tie"

### getMapper

public FileNameMapper getMapper()
This implementation returns a mapper that may return up to two file names.

- for JRMP it will return *_getStubClassSuffix (and *_getSkelClassSuffix if JDK 1.1 is used)
- for IDL it will return a random name, causing <rmic> to always recompile.
- for IIOP it will return _*_getStubClassSuffix for interfaces and _*_getStubClassSuffix for non-interfaces (and determine the interface and create _*_Stub from that).

Specified by:
  `getMapper` in interface `RmicAdapter`
Returns:
  a `FileNameMapper`

### getClasspath

public Path getClasspath()
Gets the CLASSPATH this rmic process will use.

Specified by:
  `getClasspath` in interface `RmicAdapter`
Returns:
  the classpath

### getCompileClasspath

protected Path getCompileClasspath()
Builds the compilation classpath.

Returns:
  the classpath

### areIiopAndIdlSupported

protected boolean areIiopAndIdlSupported()
Whether the iiop and idl switches are supported.

This implementation returns false if running on Java 11 onwards and true otherwise.

Returns:
  true if the iiop and idl switches are supported
Since:
  Ant 1.10.3

### setupRmicCommand

protected Commandline setupRmicCommand()
Setup rmic argument for rmic.

Returns:
  the command line

### setupRmicCommand

protected Commandline setupRmicCommand(String[] options)
Setup rmic argument for rmic.

Parameters:
  `options` - additional parameters needed by a specific implementation.
Returns:
  the command line

### addStubVersionOptions

protected String addStubVersionOptions()
This is an override point; get the stub version off the rmic command and translate that into a compiler-specific argument

Returns:
  a string to use for the stub version; can be null
Since:
  Ant1.7.1

### preprocessCompilerArgs

protected String[] preprocessCompilerArgs(String[] compilerArgs)
Preprocess the compiler arguments in any way you see fit. This is to allow compiler adapters to validate or filter the arguments. The base implementation returns the original compiler arguments unchanged.

Parameters:
  `compilerArgs` - the original compiler arguments
Returns:
  the filtered set.

### filterJvmCompilerArgs

protected String[] filterJvmCompilerArgs(String[] compilerArgs)
Strip out all -J args from the command list. Invoke this from `preprocessCompilerArgs(String[])` if you have a non-forking compiler.

Parameters:
  `compilerArgs` - the original compiler arguments
Returns:
  the filtered set.

### logAndAddFilesToCompile

protected void logAndAddFilesToCompile(Commandline cmd)
Logs the compilation parameters, adds the files to compile and logs the "niceSourceList"

Parameters:
  `cmd` - the commandline args