javax.activation: public class: MailcapCommandMap

javax.activation
public class: MailcapCommandMap [javadoc | source]

java.lang.Object
   javax.activation.CommandMap
      javax.activation.MailcapCommandMap

MailcapCommandMap extends the CommandMap abstract class. It implements a CommandMap whose configuration is based on mailcap files (RFC 1524). The MailcapCommandMap can be configured both programmatically and via configuration files.

Mailcap file search order:

The MailcapCommandMap looks in various places in the user's system for mailcap file entries. When requests are made to search for commands in the MailcapCommandMap, it searches mailcap files in the following order:

Programatically added entries to the MailcapCommandMap instance.
The file .mailcap in the user's home directory.
The file <java.home>/lib/mailcap.
The file or resources named META-INF/mailcap.
The file or resource named META-INF/mailcap.default (usually found only in the activation.jar file).

Mailcap file format:

Mailcap files must conform to the mailcap file specification (RFC 1524, A User Agent Configuration Mechanism For Multimedia Mail Format Information). The file format consists of entries corresponding to particular MIME types. In general, the specification specifies applications for clients to use when they themselves cannot operate on the specified MIME type. The MailcapCommandMap extends this specification by using a parameter mechanism in mailcap files that allows JavaBeans(tm) components to be specified as corresponding to particular commands for a MIME type.

When a mailcap file is parsed, the MailcapCommandMap recognizes certain parameter signatures, specifically those parameter names that begin with x-java-. The MailcapCommandMap uses this signature to find command entries for inclusion into its registries. Parameter names with the form x-java-<name> are read by the MailcapCommandMap as identifying a command with the name name. When the name is content-handler the MailcapCommandMap recognizes the class signified by this parameter as a DataContentHandler. All other commands are handled generically regardless of command name. The command implementation is specified by a fully qualified class name of a JavaBean(tm) component. For example; a command for viewing some data can be specified as: x-java-view=com.foo.ViewBean.

When the command name is fallback-entry, the value of the command may be true or false. An entry for a MIME type that includes a parameter of x-java-fallback-entry=true defines fallback commands for that MIME type that will only be used if no non-fallback entry can be found. For example, an entry of the form text/*; ; x-java-fallback-entry=true; x-java-view=com.sun.TextViewer specifies a view command to be used for any text MIME type. This view command would only be used if a non-fallback view command for the MIME type could not be found.

MailcapCommandMap aware mailcap files have the following general form:

# Comments begin with a '#' and continue to the end of the line. <mime type>; ; <parameter list> # Where a parameter list consists of one or more parameters, # where parameters look like: x-java-view=com.sun.TextViewer # and a parameter list looks like: text/plain; ; x-java-view=com.sun.TextViewer; x-java-edit=com.sun.TextEdit # Note that mailcap entries that do not contain 'x-java' parameters # and comply to RFC 1524 are simply ignored: image/gif; /usr/dt/bin/sdtimage %s

author: Bart - Calder

author: Bill - Shannon

since: 1.6 -

Constructor:

Constructor:
public MailcapCommandMap() { super(); List dbv = new ArrayList(5); // usually 5 or less databases MailcapFile mf = null; dbv.add(null); // place holder for PROG entry LogSupport.log("MailcapCommandMap: load HOME"); try { String user_home = System.getProperty("user.home"); if (user_home != null) { String path = user_home + File.separator + ".mailcap"; mf = loadFile(path); if (mf != null) dbv.add(mf); } } catch (SecurityException ex) {} LogSupport.log("MailcapCommandMap: load SYS"); try { // check system's home String system_mailcap = System.getProperty("java.home") + File.separator + "lib" + File.separator + "mailcap"; mf = loadFile(system_mailcap); if (mf != null) dbv.add(mf); } catch (SecurityException ex) {} LogSupport.log("MailcapCommandMap: load JAR"); // load from the app's jar file loadAllResources(dbv, "META-INF/mailcap"); LogSupport.log("MailcapCommandMap: load DEF"); synchronized (MailcapCommandMap.class) { // see if another instance has created this yet. if (defDB == null) defDB = loadResource("/META-INF/mailcap.default"); } if (defDB != null) dbv.add(defDB); DB = new MailcapFile[dbv.size()]; DB = (MailcapFile[])dbv.toArray(DB); } The default Constructor.
public MailcapCommandMap(String fileName) throws IOException { this(); if (LogSupport.isLoggable()) LogSupport.log("MailcapCommandMap: load PROG from " + fileName); if (DB[PROG] == null) { DB[PROG] = new MailcapFile(fileName); } } Constructor that allows the caller to specify the path of a mailcap file. Parameters: `fileName` - The name of the mailcap file to open Throws: `IOException` - if the file can't be accessed exception: `IOException` - if the file can't be accessed
public MailcapCommandMap(InputStream is) { this(); LogSupport.log("MailcapCommandMap: load PROG"); if (DB[PROG] == null) { try { DB[PROG] = new MailcapFile(is); } catch (IOException ex) { // XXX - should throw it } } } Constructor that allows the caller to specify an InputStream containing a mailcap file. Parameters: `is` - InputStream of the mailcap file to open

 public MailcapCommandMap() {
        super();
        List dbv = new ArrayList(5);    // usually 5 or less databases
        MailcapFile mf = null;
        dbv.add(null);          // place holder for PROG entry
        LogSupport.log("MailcapCommandMap: load HOME");
        try {
            String user_home = System.getProperty("user.home");
            if (user_home != null) {
                String path = user_home + File.separator + ".mailcap";
                mf = loadFile(path);
                if (mf != null)
                    dbv.add(mf);
            }
        } catch (SecurityException ex) {}
        LogSupport.log("MailcapCommandMap: load SYS");
        try {
            // check system's home
            String system_mailcap = System.getProperty("java.home") +
                File.separator + "lib" + File.separator + "mailcap";
            mf = loadFile(system_mailcap);
            if (mf != null)
                dbv.add(mf);
        } catch (SecurityException ex) {}
        LogSupport.log("MailcapCommandMap: load JAR");
        // load from the app's jar file
        loadAllResources(dbv, "META-INF/mailcap");
        LogSupport.log("MailcapCommandMap: load DEF");
        synchronized (MailcapCommandMap.class) {
            // see if another instance has created this yet.
            if (defDB == null)
                defDB = loadResource("/META-INF/mailcap.default");
        }
        if (defDB != null)
            dbv.add(defDB);
        DB = new MailcapFile[dbv.size()];
        DB = (MailcapFile[])dbv.toArray(DB);
}

The default Constructor.

 public MailcapCommandMap(String fileName) throws IOException {
        this();
        if (LogSupport.isLoggable())
            LogSupport.log("MailcapCommandMap: load PROG from " + fileName);
        if (DB[PROG] == null) {
            DB[PROG] = new MailcapFile(fileName);
        }
}

mailcap

Parameters:

fileName - The name of the mailcap file to open

Throws:

IOException - if the file can't be accessed

exception: IOException - if the file can't be accessed

 public MailcapCommandMap(InputStream is) {
        this();
        LogSupport.log("MailcapCommandMap: load PROG");
        if (DB[PROG] == null) {
            try {
                DB[PROG] = new MailcapFile(is);
            } catch (IOException ex) {
                // XXX - should throw it
            }
        }
}

InputStream

Parameters:

is - InputStream of the mailcap file to open

Method from javax.activation.MailcapCommandMap Summary:
addMailcap, createDataContentHandler, getAllCommands, getCommand, getMimeTypes, getNativeCommands, getPreferredCommands

Methods from javax.activation.CommandMap:
createDataContentHandler, createDataContentHandler, getAllCommands, getAllCommands, getCommand, getCommand, getDefaultCommandMap, getMimeTypes, getPreferredCommands, getPreferredCommands, setDefaultCommandMap

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from javax.activation.MailcapCommandMap Detail:
public synchronized void addMailcap(String mail_cap) { // check to see if one exists LogSupport.log("MailcapCommandMap: add to PROG"); if (DB[PROG] == null) DB[PROG] = new MailcapFile(); DB[PROG].appendToMailcap(mail_cap); } Add entries to the registry. Programmatically added entries are searched before other entries. The string that is passed in should be in mailcap format.
public synchronized DataContentHandler createDataContentHandler(String mimeType) { if (LogSupport.isLoggable()) LogSupport.log( "MailcapCommandMap: createDataContentHandler for " + mimeType); if (mimeType != null) mimeType = mimeType.toLowerCase(Locale.ENGLISH); for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; if (LogSupport.isLoggable()) LogSupport.log(" search DB #" + i); Map cmdMap = DB[i].getMailcapList(mimeType); if (cmdMap != null) { List v = (List)cmdMap.get("content-handler"); if (v != null) { String name = (String)v.get(0); DataContentHandler dch = getDataContentHandler(name); if (dch != null) return dch; } } } // now try the fallback entries for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; if (LogSupport.isLoggable()) LogSupport.log(" search fallback DB #" + i); Map cmdMap = DB[i].getMailcapFallbackList(mimeType); if (cmdMap != null) { List v = (List)cmdMap.get("content-handler"); if (v != null) { String name = (String)v.get(0); DataContentHandler dch = getDataContentHandler(name); if (dch != null) return dch; } } } return null; } Return the DataContentHandler for the specified MIME type.
public synchronized CommandInfo[] getAllCommands(String mimeType) { List cmdList = new ArrayList(); if (mimeType != null) mimeType = mimeType.toLowerCase(Locale.ENGLISH); for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; Map cmdMap = DB[i].getMailcapList(mimeType); if (cmdMap != null) appendCmdsToList(cmdMap, cmdList); } // now add the fallback commands for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; Map cmdMap = DB[i].getMailcapFallbackList(mimeType); if (cmdMap != null) appendCmdsToList(cmdMap, cmdList); } CommandInfo[] cmdInfos = new CommandInfo[cmdList.size()]; cmdInfos = (CommandInfo[])cmdList.toArray(cmdInfos); return cmdInfos; } Get all the available commands in all mailcap files known to this instance of MailcapCommandMap for this MIME type.
public synchronized CommandInfo getCommand(String mimeType, String cmdName) { if (mimeType != null) mimeType = mimeType.toLowerCase(Locale.ENGLISH); for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; Map cmdMap = DB[i].getMailcapList(mimeType); if (cmdMap != null) { // get the cmd list for the cmd List v = (List)cmdMap.get(cmdName); if (v != null) { String cmdClassName = (String)v.get(0); if (cmdClassName != null) return new CommandInfo(cmdName, cmdClassName); } } } // now try the fallback list for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; Map cmdMap = DB[i].getMailcapFallbackList(mimeType); if (cmdMap != null) { // get the cmd list for the cmd List v = (List)cmdMap.get(cmdName); if (v != null) { String cmdClassName = (String)v.get(0); if (cmdClassName != null) return new CommandInfo(cmdName, cmdClassName); } } } return null; } Get the command corresponding to `cmdName` for the MIME type.
public synchronized String[] getMimeTypes() { List mtList = new ArrayList(); for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; String[] ts = DB[i].getMimeTypes(); if (ts != null) { for (int j = 0; j < ts.length; j++) { // eliminate duplicates if (!mtList.contains(ts[j])) mtList.add(ts[j]); } } } String[] mts = new String[mtList.size()]; mts = (String[])mtList.toArray(mts); return mts; } Get all the MIME types known to this command map.
public synchronized String[] getNativeCommands(String mimeType) { List cmdList = new ArrayList(); if (mimeType != null) mimeType = mimeType.toLowerCase(Locale.ENGLISH); for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; String[] cmds = DB[i].getNativeCommands(mimeType); if (cmds != null) { for (int j = 0; j < cmds.length; j++) { // eliminate duplicates if (!cmdList.contains(cmds[j])) cmdList.add(cmds[j]); } } } String[] cmds = new String[cmdList.size()]; cmds = (String[])cmdList.toArray(cmds); return cmds; } Get the native commands for the given MIME type. Returns an array of strings where each string is an entire mailcap file entry. The application will need to parse the entry to extract the actual command as well as any attributes it needs. See RFC 1524 for details of the mailcap entry syntax. Only mailcap entries that specify a view command for the specified MIME type are returned.
public synchronized CommandInfo[] getPreferredCommands(String mimeType) { List cmdList = new ArrayList(); if (mimeType != null) mimeType = mimeType.toLowerCase(Locale.ENGLISH); for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; Map cmdMap = DB[i].getMailcapList(mimeType); if (cmdMap != null) appendPrefCmdsToList(cmdMap, cmdList); } // now add the fallback commands for (int i = 0; i < DB.length; i++) { if (DB[i] == null) continue; Map cmdMap = DB[i].getMailcapFallbackList(mimeType); if (cmdMap != null) appendPrefCmdsToList(cmdMap, cmdList); } CommandInfo[] cmdInfos = new CommandInfo[cmdList.size()]; cmdInfos = (CommandInfo[])cmdList.toArray(cmdInfos); return cmdInfos; } Get the preferred command list for a MIME Type. The MailcapCommandMap searches the mailcap files as described above under Mailcap file search order. The result of the search is a proper subset of available commands in all mailcap files known to this instance of MailcapCommandMap. The first entry for a particular command is considered the preferred command.

Method from javax.activation.MailcapCommandMap Detail:

 public synchronized  void addMailcap(String mail_cap) {
        // check to see if one exists
        LogSupport.log("MailcapCommandMap: add to PROG");
        if (DB[PROG] == null)
            DB[PROG] = new MailcapFile();
        DB[PROG].appendToMailcap(mail_cap);
}

The string that is passed in should be in mailcap format.

 public synchronized DataContentHandler createDataContentHandler(String mimeType) {
        if (LogSupport.isLoggable())
            LogSupport.log(
                "MailcapCommandMap: createDataContentHandler for " + mimeType);
        if (mimeType != null)
            mimeType = mimeType.toLowerCase(Locale.ENGLISH);
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            if (LogSupport.isLoggable())
                LogSupport.log("  search DB #" + i);
            Map cmdMap = DB[i].getMailcapList(mimeType);
            if (cmdMap != null) {
                List v = (List)cmdMap.get("content-handler");
                if (v != null) {
                    String name = (String)v.get(0);
                    DataContentHandler dch = getDataContentHandler(name);
                    if (dch != null)
                        return dch;
                }
            }
        }
        // now try the fallback entries
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            if (LogSupport.isLoggable())
                LogSupport.log("  search fallback DB #" + i);
            Map cmdMap = DB[i].getMailcapFallbackList(mimeType);
            if (cmdMap != null) {
                List v = (List)cmdMap.get("content-handler");
                if (v != null) {
                    String name = (String)v.get(0);
                    DataContentHandler dch = getDataContentHandler(name);
                    if (dch != null)
                        return dch;
                }
            }
        }
        return null;
}

Return the DataContentHandler for the specified MIME type.

 public synchronized CommandInfo[] getAllCommands(String mimeType) {
        List cmdList = new ArrayList();
        if (mimeType != null)
            mimeType = mimeType.toLowerCase(Locale.ENGLISH);
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            Map cmdMap = DB[i].getMailcapList(mimeType);
            if (cmdMap != null)
                appendCmdsToList(cmdMap, cmdList);
        }
        // now add the fallback commands
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            Map cmdMap = DB[i].getMailcapFallbackList(mimeType);
            if (cmdMap != null)
                appendCmdsToList(cmdMap, cmdList);
        }
        CommandInfo[] cmdInfos = new CommandInfo[cmdList.size()];
        cmdInfos = (CommandInfo[])cmdList.toArray(cmdInfos);
        return cmdInfos;
}

Get all the available commands in all mailcap files known to this instance of MailcapCommandMap for this MIME type.

 public synchronized CommandInfo getCommand(String mimeType,
    String cmdName) {
        if (mimeType != null)
            mimeType = mimeType.toLowerCase(Locale.ENGLISH);
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            Map cmdMap = DB[i].getMailcapList(mimeType);
            if (cmdMap != null) {
                // get the cmd list for the cmd
                List v = (List)cmdMap.get(cmdName);
                if (v != null) {
                    String cmdClassName = (String)v.get(0);
                    if (cmdClassName != null)
                        return new CommandInfo(cmdName, cmdClassName);
                }
            }
        }
        // now try the fallback list
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            Map cmdMap = DB[i].getMailcapFallbackList(mimeType);
            if (cmdMap != null) {
                // get the cmd list for the cmd
                List v = (List)cmdMap.get(cmdName);
                if (v != null) {
                    String cmdClassName = (String)v.get(0);
                    if (cmdClassName != null)
                        return new CommandInfo(cmdName, cmdClassName);
                }
            }
        }
        return null;
}

cmdName

 public synchronized String[] getMimeTypes() {
        List mtList = new ArrayList();
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            String[] ts = DB[i].getMimeTypes();
            if (ts != null) {
                for (int j = 0; j <  ts.length; j++) {
                    // eliminate duplicates
                    if (!mtList.contains(ts[j]))
                        mtList.add(ts[j]);
                }
            }
        }
        String[] mts = new String[mtList.size()];
        mts = (String[])mtList.toArray(mts);
        return mts;
}

Get all the MIME types known to this command map.

 public synchronized String[] getNativeCommands(String mimeType) {
        List cmdList = new ArrayList();
        if (mimeType != null)
            mimeType = mimeType.toLowerCase(Locale.ENGLISH);
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            String[] cmds = DB[i].getNativeCommands(mimeType);
            if (cmds != null) {
                for (int j = 0; j <  cmds.length; j++) {
                    // eliminate duplicates
                    if (!cmdList.contains(cmds[j]))
                        cmdList.add(cmds[j]);
                }
            }
        }
        String[] cmds = new String[cmdList.size()];
        cmds = (String[])cmdList.toArray(cmds);
        return cmds;
}

RFC 1524

 public synchronized CommandInfo[] getPreferredCommands(String mimeType) {
        List cmdList = new ArrayList();
        if (mimeType != null)
            mimeType = mimeType.toLowerCase(Locale.ENGLISH);
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            Map cmdMap = DB[i].getMailcapList(mimeType);
            if (cmdMap != null)
                appendPrefCmdsToList(cmdMap, cmdList);
        }
        // now add the fallback commands
        for (int i = 0; i <  DB.length; i++) {
            if (DB[i] == null)
                continue;
            Map cmdMap = DB[i].getMailcapFallbackList(mimeType);
            if (cmdMap != null)
                appendPrefCmdsToList(cmdMap, cmdList);
        }
        CommandInfo[] cmdInfos = new CommandInfo[cmdList.size()];
        cmdInfos = (CommandInfo[])cmdList.toArray(cmdInfos);
        return cmdInfos;
}

Mailcap file search order

The result of the search is a proper subset of available commands in all mailcap files known to this instance of MailcapCommandMap. The first entry for a particular command is considered the preferred command.