diff -r 9d598f7f02da -r 014f8c42e1d4 java_stubs/javaregistry/clientserver/client/inc/javaregconverter.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/java_stubs/javaregistry/clientserver/client/inc/javaregconverter.h Mon Feb 22 17:55:27 2010 +0200 @@ -0,0 +1,238 @@ +/* +* Copyright (c) 2005-2006 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: javaregconverter definition +* +*/ + + +#ifndef JAVAREGCONVERTER_H +#define JAVAREGCONVERTER_H + +// INCLUDES +#include + +// FORWARD DECLARATION +class TAppVersion; + +namespace Java +{ +namespace Manager +{ +namespace Registry +{ +// FORWARD DECLARATION +class CJavaProperty; + +// CLASS DECLARATION +/** + * This class has only static methods, that help to store some types, + * and structures in descriptors, and to retrieve them. It is mainly used + * by the javaregistry internal API. + * + * @lib javaregistryclient.lib + * @since S60 v3.2 + */ +class JavaRegConverter +{ +public: + + /** + * JavaRegConverter::GetTAppVersion method converts the descriptor + * parameter to a TAppVersion. + * + * @since S60 v3.2 + * @param aValue A descriptor storing a TAppVersion. + * @param aDefault The value to be returned if aValue does'nt contain + * valid data. + * @return A TAppVersion stored in the descriptor parameter. + */ + IMPORT_C static TAppVersion GetTAppVersion( + const TDesC& aValue, + TAppVersion aDefault); + + /** + * JavaRegConverter::GetTAppVersionL method converts the descriptor + * parameter to a TAppVersion. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue A descriptor storing a TAppVersion. + * @return A TAppVersion stored in the descriptor parameter. + */ + IMPORT_C static TAppVersion GetTAppVersionL(const TDesC& aValue); + + /** + * JavaRegConverter::StoreTAppVersionL method stores the TAppVersion + * parameter into the descriptor paramameter, that is instantiated by + * this method. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue The TAppVersion value to be stored. + * @param aDes [out] Descriptor parameter, storing, and the returning + * the TAppVersion value. + */ + IMPORT_C static void StoreTAppVersionL( + const TAppVersion& aValue, + HBufC*& aDes); + + + /** + * JavaRegConverter::GetTInt method converts the descriptor + * parameter to a TInt32. + * + * @since S60 v3.2 + * @param aValue A descriptor storing a TInt32. + * @param aDefault The value to be returned if aValue does'nt contain + * valid data. + * @return A TInt32 stored in the descriptor parameter. + */ + IMPORT_C static TInt32 GetTInt(const TDesC& aValue, TInt32 aDefault); + + /** + * JavaRegConverter::GetTIntL method converts the descriptor + * parameter to a TInt32. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue A descriptor storing a TInt32. + * @return A TInt32 stored in the descriptor parameter. + */ + IMPORT_C static TInt32 GetTIntL(const TDesC& aValue); + + + /** + * JavaRegConverter::StoreTIntL method stores the TInt32 + * parameter into the descriptor paramameter, that is instantiated by + * this method. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue The TInt32 value to be stored. + * @param aDes [out] Descriptor parameter, storing, and the returning + * the TInt32 value. + */ + IMPORT_C static void StoreTIntL(const TInt32 aValue, HBufC*& aDes); + + /** + * JavaRegConverter::GetTBool method converts the descriptor + * parameter to a TBool. + * + * @since S60 v3.2 + * @param aValue A descriptor storing a TBool. + * @param aDefault The value to be returned if aValue does'nt contain + * valid data. + * @return A TBool stored in the descriptor parameter. + */ + IMPORT_C static TBool GetTBool(const TDesC& aValue, TBool aDefault); + + + /** + * JavaRegConverter::GetTBoolL method converts the descriptor + * parameter to a TBool. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue A descriptor storing a TBool. + * @return A TBool stored in the descriptor parameter. + */ + IMPORT_C static TBool GetTBoolL(const TDesC& aValue); + + + /** + * JavaRegConverter::StoreTBoolL method stores the TBool + * parameter into the descriptor paramameter, that is instantiated by + * this method. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue The TBool value to be stored. + * @param aDes [out] Descriptor parameter, storing, and the returning + * the TBool value. + */ + IMPORT_C static void StoreTBoolL(const TBool aValue, HBufC*& aDes); + + + + /** + * JavaRegConverter::GetCertificateChainsL method converts the + * descriptor parameter to a RPointerArray storing + * certificate chains. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue A descriptor storing certificate chains. + * @param aCertChains [out] The method converts the certificate chains + * into this RPointerArray. + */ + IMPORT_C static void GetCertificateChainsL( + const TDesC& aValue, + RPointerArray& aCertChains); + + + /** + * JavaRegConverter::StoreCertificateChainsL method stores the + * certificate chains ( given in the first parameter ), + * into the descriptor paramameter, that is instantiated by + * this method. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue The certificate chains to be stored. + * @param aDes [out] Descriptor parameter, storing, and the returning + * the certificate chains. + */ + IMPORT_C static void StoreCertificateChainsL( + const RPointerArray& aValue, + HBufC*& aDes); + + + /** + * JavaRegConverter::GetUnicodeDescriptorsL method converts the + * descriptor parameter to a RPointerArray storing + * unicode descriptors. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue A descriptor storing unicode descriptors. + * @param aCertChains [out] The method converts the unicode descriptors + * into this RPointerArray. + */ + IMPORT_C static void JavaRegConverter::GetUnicodeDescriptorsL( + const TDesC& aValue, + RPointerArray& aDescriptors); + /** + * JavaRegConverter::StoreUnicodeDescriptorsL method stores the + * unicode descriptors ( given in the first parameter ), + * into the descriptor paramameter, that is instantiated by + * this method. + * The function may leave with one of the system-wide error codes. + * + * @since S60 v3.2 + * @param aValue The certificate chains to be stored. + * @param aDes [out] Descriptor parameter, storing, and the returning + * the certificate chains. + */ + IMPORT_C static void JavaRegConverter::StoreUnicodeDescriptorsL( + const RPointerArray& aValue, + HBufC*& aDes); +}; + +}// namespace Registry +}// namespace Manager +}// namespace Java + +#endif // JAVAREGCONVERTER_H + +// End of File