Package net.fabricmc.mappingio.adapter

Class MappingSourceNsSwitch

java.lang.Object

net.fabricmc.mappingio.adapter.ForwardingMappingVisitor

net.fabricmc.mappingio.adapter.MappingSourceNsSwitch

All Implemented Interfaces:

MappingVisitor

public final class MappingSourceNsSwitch
extends ForwardingMappingVisitor

Adapter switching the source namespace with one of the destination namespaces.

This adapts e.g. "src -> dstA, dstB, dstC, ..." mappings to "dstB -> dstA, src, dstC, ..." with a pre-pass to build a class map for descriptor remapping.

After gathering the class map, the implementation delays src-named visit* invocations until the replacement dst name is known, then replays it with the adjusted names.

By default elements without a name in newSourceNs will keep using the original srcName. This behavior can be changed by setting dropMissingNewSrcName to true in the constructor.

Field Summary

Fields inherited from class net.fabricmc.mappingio.adapter.ForwardingMappingVisitor

next

Constructor Summary

Constructors

Constructor	Description
MappingSourceNsSwitch(MappingVisitor next, String newSourceNs)
MappingSourceNsSwitch(MappingVisitor next, String newSourceNs, boolean dropMissingNewSrcName)	Create a new MappingSourceNsSwitch instance.

Method Summary

Modifier and Type	Method	Description
Set<MappingFlag>	getFlags()
void	reset()	Reset the visitor including any chained visitors to allow for another independent visit (excluding visitEnd=false).
boolean	visitClass(String srcName)
boolean	visitContent()	Determine whether the mapping content (classes and anything below, metadata if not part of the header) should be visited.
void	visitDstDesc(MappedElementKind targetKind, int namespace, String desc)
void	visitDstName(MappedElementKind targetKind, int namespace, String name)	Destination name for the current element.
boolean	visitElementContent(MappedElementKind targetKind)	Determine whether the element content (comment, sub-elements) should be visited.
boolean	visitEnd()	Finish the visitation pass.
boolean	visitField(String srcName, @Nullable String srcDesc)
boolean	visitHeader()	Determine whether the header (namespaces, metadata if part of the header) should be visited.
void	visitMetadata(String key, @Nullable String value)
boolean	visitMethod(String srcName, @Nullable String srcDesc)
boolean	visitMethodArg(int argPosition, int lvIndex, @Nullable String srcName)
boolean	visitMethodVar(int lvtRowIndex, int lvIndex, int startOpIdx, int endOpIdx, @Nullable String srcName)
void	visitNamespaces(String srcNamespace, List<String> dstNamespaces)

Methods inherited from class net.fabricmc.mappingio.adapter.ForwardingMappingVisitor

visitComment

Methods inherited from class java.lang.Object

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

Constructor Details

MappingSourceNsSwitch

public MappingSourceNsSwitch(MappingVisitor next,
 String newSourceNs)

MappingSourceNsSwitch

public MappingSourceNsSwitch(MappingVisitor next,
 String newSourceNs,
 boolean dropMissingNewSrcName)

Create a new MappingSourceNsSwitch instance.

Parameters:

next - MappingVisitor to pass the output to

newSourceNs - namespace to use for the new source name

dropMissingNewSrcName - whether to drop elements without a name in newSourceNs, will use original srcName otherwise

Method Details

getFlags

public Set<MappingFlag> getFlags()

Specified by:

getFlags in interface MappingVisitor

Overrides:

getFlags in class ForwardingMappingVisitor

reset

public void reset()

Description copied from interface: MappingVisitor

Reset the visitor including any chained visitors to allow for another independent visit (excluding visitEnd=false).

Specified by:

reset in interface MappingVisitor

Overrides:

reset in class ForwardingMappingVisitor

visitHeader

public boolean visitHeader()
                    throws IOException

Description copied from interface: MappingVisitor

Determine whether the header (namespaces, metadata if part of the header) should be visited.

Specified by:

visitHeader in interface MappingVisitor

Overrides:

visitHeader in class ForwardingMappingVisitor

Returns:

true if the header is to be visited, false otherwise

Throws:

IOException

visitNamespaces

public void visitNamespaces(String srcNamespace,
 List<String> dstNamespaces)
                     throws IOException

Specified by:

visitNamespaces in interface MappingVisitor

Overrides:

visitNamespaces in class ForwardingMappingVisitor

Throws:

IOException

visitMetadata

public void visitMetadata(String key,
 @Nullable
 @Nullable String value)
                   throws IOException

Specified by:

visitMetadata in interface MappingVisitor

Overrides:

visitMetadata in class ForwardingMappingVisitor

Throws:

IOException

visitContent

public boolean visitContent()
                     throws IOException

Description copied from interface: MappingVisitor

Determine whether the mapping content (classes and anything below, metadata if not part of the header) should be visited.

Specified by:

visitContent in interface MappingVisitor

Overrides:

visitContent in class ForwardingMappingVisitor

Returns:

true if content is to be visited, false otherwise

Throws:

IOException

visitClass

public boolean visitClass(String srcName)
                   throws IOException

Specified by:

visitClass in interface MappingVisitor

Overrides:

visitClass in class ForwardingMappingVisitor

Throws:

IOException

visitField

public boolean visitField(String srcName,
 @Nullable
 @Nullable String srcDesc)
                   throws IOException

Specified by:

visitField in interface MappingVisitor

Overrides:

visitField in class ForwardingMappingVisitor

Throws:

IOException

visitMethod

public boolean visitMethod(String srcName,
 @Nullable
 @Nullable String srcDesc)
                    throws IOException

Specified by:

visitMethod in interface MappingVisitor

Overrides:

visitMethod in class ForwardingMappingVisitor

Throws:

IOException

visitMethodArg

public boolean visitMethodArg(int argPosition,
 int lvIndex,
 @Nullable
 @Nullable String srcName)
                       throws IOException

Specified by:

visitMethodArg in interface MappingVisitor

Overrides:

visitMethodArg in class ForwardingMappingVisitor

Throws:

IOException

visitMethodVar

public boolean visitMethodVar(int lvtRowIndex,
 int lvIndex,
 int startOpIdx,
 int endOpIdx,
 @Nullable
 @Nullable String srcName)
                       throws IOException

Specified by:

visitMethodVar in interface MappingVisitor

Overrides:

visitMethodVar in class ForwardingMappingVisitor

Throws:

IOException

visitEnd

public boolean visitEnd()
                 throws IOException

Description copied from interface: MappingVisitor

Finish the visitation pass.

Specified by:

visitEnd in interface MappingVisitor

Overrides:

visitEnd in class ForwardingMappingVisitor

Returns:

true if the visitation pass is final, false if it should be started over

Throws:

IOException

visitDstName

public void visitDstName(MappedElementKind targetKind,
 int namespace,
 String name)
                  throws IOException

Description copied from interface: MappingVisitor

Destination name for the current element.

Specified by:

visitDstName in interface MappingVisitor

Overrides:

visitDstName in class ForwardingMappingVisitor

Parameters:

namespace - namespace index, index into the dstNamespaces List in MappingVisitor.visitNamespaces(java.lang.String, java.util.List<java.lang.String>)

name - destination name

Throws:

IOException

visitDstDesc

public void visitDstDesc(MappedElementKind targetKind,
 int namespace,
 String desc)
                  throws IOException

Specified by:

visitDstDesc in interface MappingVisitor

Overrides:

visitDstDesc in class ForwardingMappingVisitor

Throws:

IOException

visitElementContent

public boolean visitElementContent(MappedElementKind targetKind)
                            throws IOException

Description copied from interface: MappingVisitor

Determine whether the element content (comment, sub-elements) should be visited.

Called after visiting the target itself (e.g. visitClass for targetKind=class), its dst names and descs, but before any child elements or the comment.

This is also a notification about all available dst names having been passed on.

Specified by:

visitElementContent in interface MappingVisitor

Overrides:

visitElementContent in class ForwardingMappingVisitor

Returns:

true if the contents are to be visited, false otherwise

Throws:

IOException