org.mule.runtime.api.component.location

Interface ComponentLocation

public interface ComponentLocation

Provides information about the location of a component within an application. A component location describes where the component is defined in the configuration of the artifact. For instance:

• COMPONENT_NAME - global component defined with name COMPONENT_NAME
• FLOW_NAME/source - a source defined within a flow
• FLOW_NAME/processors/0 - the first processor defined within a flow with name FLOW_NAME
• FLOW_NAME/processors/4/1 - the first processors defined inside another processor which is positioned fifth within a flow with name FLOW_NAME
• FLOW_NAME/errorHandler/0 - the first on-error within the error handler
• FLOW_NAME/0/errorHandler/3 - the third on-error within the error handler of the first element of the flow with name FLOW_NAME

The different LocationParts in FLOW_NAME/processors/1 are:

• 'processors' as partPath and no component identifier since this part is synthetic to indicate the part of the flow referenced by the next index
• '1' as partPath and 'mule:payload' as component identifier assuming that the second processor of the flow was a set-payload component

Since:

1.0

Method Summary

Modifier and Type	Method and Description
TypedComponentIdentifier	getComponentIdentifier()
Optional<String>	getFileName()
Optional<Integer>	getLineInFile()
String	getLocation()
List<LocationPart>	getParts()
String	getRootContainerName() Gets the name of the root containing element.

Method Detail

getLocation

String getLocation()

Returns:

the unique absolute path of the component in the application.

getFileName

Optional<String> getFileName()

Returns:

the config file of the application where this component is defined, if it was defined in a config file.

getLineInFile

Optional<Integer> getLineInFile()

Returns:

the line number in the config file of the application where this component is defined, if it was defined in a config file.

getParts

List<LocationPart> getParts()

Returns:

the list of parts for the location. The location starts with the global element containing the component and continues with the next elements within the global element until the last part which is the component specific part.

getComponentIdentifier

TypedComponentIdentifier getComponentIdentifier()

Returns:

the ComponentIdentifier of the component associated with this location

getRootContainerName

String getRootContainerName()

Gets the name of the root containing element.

Returns:

the first part path of this location. Non-null.