org.openide.filesystems 8.5.1

org.openide.filesystems
Class MIMEResolver

java.lang.Object
  extended by org.openide.filesystems.MIMEResolver

public abstract class MIMEResolver
extends Object

Use the FileUtil.getMIMEType(org.openide.filesystems.FileObject, java.lang.String[]) to invoke the mime resolving infrastructure. All registered mime resolvers are looked up and asked one by one to resolve MIME type of passed in FileObject. Resolving is finished right after a resolver is able to resolve the FileObject or if all registered resolvers returned null (not recognized).

Use MIMEResolver.ExtensionRegistration, MIMEResolver.NamespaceRegistration or MIMEResolver.Registration to register declarative resolvers.

In the rarely case, when declarative resolvers are not sufficient, you can register subclass of MIMEResolver directly by using ServiceProvider annotation.


Nested Class Summary
static interface MIMEResolver.ExtensionRegistration
          Often a mime type can be deduced just by looking at a file extension.
static interface MIMEResolver.NamespaceRegistration
          Recognize mime type by looking into header of XML files.
static interface MIMEResolver.Registration
          Registration that allows effective, declarative registration of complex mime resolvers.
 class MIMEResolver.UIHelpers
          Internal support for implementors of MIME resolver UIs.
 
Constructor Summary
MIMEResolver()
          Deprecated. Use MIMEResolver(String...) instead. Declaring MIME types which can only be resolved by this resolver helps to speed up IDE.
MIMEResolver(String... mimeTypes)
          Creates a new MIMEResolver.
 
Method Summary
abstract  String findMIMEType(FileObject fo)
          Resolves FileObject and returns recognized MIME type
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

MIMEResolver

public MIMEResolver(String... mimeTypes)
Creates a new MIMEResolver.

Parameters:
mimeTypes - an array of MIME types which can be resolved by this resolver. It should contain all MIME types which findMIMEType(org.openide.filesystems.FileObject) can return. If something is missing, this resolver can be ignored, when searching for that missing MIME type (see FileUtil.getMIMEType(FileObject, String...)).
Since:
7.13

MIMEResolver

@Deprecated
public MIMEResolver()
Deprecated. Use MIMEResolver(String...) instead. Declaring MIME types which can only be resolved by this resolver helps to speed up IDE.

Creates a new MIMEResolver.

Method Detail

findMIMEType

public abstract String findMIMEType(FileObject fo)
Resolves FileObject and returns recognized MIME type

Parameters:
fo - is FileObject which should be resolved (This FileObject is not thread safe. Also this FileObject should not be cached for later use)
Returns:
recognized MIME type or null if not recognized

org.openide.filesystems 8.5.1

Built on June 6 2013.  |  Portions Copyright 1997-2013 Oracle. All rights reserved.