javaextensions/pim/javasrc/javax/microedition/pim/PIM.java
branchRCL_3
changeset 77 7cee158cb8cd
parent 19 04becd199f91
child 83 26b2b12093af
equal deleted inserted replaced
71:d5e927d5853b 77:7cee158cb8cd
    78      */
    78      */
    79     protected PIM()
    79     protected PIM()
    80     {
    80     {
    81     }
    81     }
    82 
    82 
       
    83     /**
       
    84      * @param aPimListType which list user want to open Ex.CONTACT_LIST, EVENT_LIST, or TODO_LIST.
       
    85      * @param aMode list open mode  READ_ONLY or  WRITE_ONLY or READ_WRITE
       
    86      * @return PIMList
       
    87      * @throws javax.microedition.pim.PIMException
       
    88      */
    83     public abstract PIMList openPIMList(int aPimListType, int aMode)
    89     public abstract PIMList openPIMList(int aPimListType, int aMode)
    84     throws PIMException;
    90     throws PIMException;
    85 
    91 
       
    92     /**
       
    93      *
       
    94      * @param aPimListType aPimListType which list user want to open Ex.CONTACT_LIST, EVENT_LIST, or TODO_LIST.
       
    95      * @param aMode list open mode  READ_ONLY or  WRITE_ONLY or READ_WRITE
       
    96      * @param aName List name
       
    97      * @return  PIMList
       
    98      * @throws javax.microedition.pim.PIMException
       
    99      */
    86     public abstract PIMList openPIMList(int aPimListType, int aMode,
   100     public abstract PIMList openPIMList(int aPimListType, int aMode,
    87                                         String aName) throws PIMException;
   101                                         String aName) throws PIMException;
    88 
   102 
       
   103     /**
       
   104      *
       
   105      * @param aPimListType  aPimListType which list user want to open Ex.CONTACT_LIST, EVENT_LIST, or TODO_LIST.
       
   106      * @return String which contains list of PIMList names
       
   107      */
    89     public abstract String[] listPIMLists(int aPimListType);
   108     public abstract String[] listPIMLists(int aPimListType);
    90 
   109 
       
   110     /**
       
   111      * @param aIs an inputstream object containing PIM information
       
   112      * @param aEnc encoding of the characters in the input stream
       
   113      * @return PIMItem Array
       
   114      * @throws javax.microedition.pim.PIMException
       
   115      * @throws java.io.UnsupportedEncodingException
       
   116      */
    91     public abstract PIMItem[] fromSerialFormat(java.io.InputStream aIs,
   117     public abstract PIMItem[] fromSerialFormat(java.io.InputStream aIs,
    92             String aEnc) throws PIMException, UnsupportedEncodingException;
   118             String aEnc) throws PIMException, UnsupportedEncodingException;
    93 
   119 
       
   120     /**
       
   121      *
       
   122      * @param aItem the item to export
       
   123      * @param aOs the OutputStream object that where is written to as a character stream.
       
   124      * @param aEnc  encoding of the characters in the input stream
       
   125      * @param aDataFormat PIM data format to use
       
   126      * @throws javax.microedition.pim.PIMException
       
   127      * @throws java.io.UnsupportedEncodingException
       
   128      */
    94     public abstract void toSerialFormat(PIMItem aItem,
   129     public abstract void toSerialFormat(PIMItem aItem,
    95                                         java.io.OutputStream aOs, String aEnc, String aDataFormat)
   130                                         java.io.OutputStream aOs, String aEnc, String aDataFormat)
    96     throws PIMException, UnsupportedEncodingException;
   131     throws PIMException, UnsupportedEncodingException;
    97 
   132 
       
   133     /**
       
   134      *
       
   135      * @param aPimListType which list user want to open Ex.CONTACT_LIST, EVENT_LIST, or TODO_LIST.
       
   136      * @return String object
       
   137      */
    98     public abstract String[] supportedSerialFormats(int aPimListType);
   138     public abstract String[] supportedSerialFormats(int aPimListType);
       
   139 
       
   140 
       
   141 
    99 }
   142 }