getFileMappingEntry method

Checks whether a resolved path name already exists in the CMS. You use this method to avoid creating multiple CMS objects from a single source file -- for example, by loading multiple entity references to one file. Before calling this method, use the objectReuse attribute to determine if this session is managing file mapping entries or not.

getFileMappingEntry(pathname )
Parameters	Stringpathname Specifies the resolved entity path name. This should be a normalized form of a local resource path. For example on Windows-based systems, the following paths all represent the same local resource: • c:\graphics\engine.jpg • c:\Graphics\Engine.JPG • c:\graphics\..\graphics\engine.jpg For this reason, the caller should normalize this path in a consistent manner before calling this method.
Returns	String. Returns the associated Logical ID, if it is in the CMS. Returns null if it is not.
Throws	CMSException If an error occurs.