--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javacommons/utils/inc.s60/s60commonutils.h Mon May 03 12:27:20 2010 +0300
@@ -0,0 +1,172 @@
+/*
+* Copyright (c) 2008 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: ?Description
+*
+*/
+
+
+#ifndef S60COMMONUTILS_H
+#define S60COMMONUTILS_H
+
+
+#include "jni.h"
+#include <e32def.h>
+#include <e32cmn.h>
+#include <wchar.h>
+#include "javaosheaders.h"
+
+namespace java
+{
+namespace util
+{
+
+class S60CommonUtils
+{
+public:
+ OS_IMPORT static TInt CopyToNative(JNIEnv& aJni, jbyteArray aJavaBuffer, TInt aOffset, TInt aLength, TDes8& aNativeBuffer);
+
+ OS_IMPORT static TInt CopyToJava(JNIEnv& aJni, const TDesC8& aNativeBuffer, jbyteArray aJavaBuffer, TInt aOffset, TInt aLength);
+
+ OS_IMPORT static jobjectArray NativeToJavaStringArray(JNIEnv& aJni, const RPointerArray<HBufC>& aNativeArray);
+
+
+ OS_IMPORT static TTime JavaTimeToTTime(jlong aJavaTime);
+
+ OS_IMPORT static jlong TTimeToJavaTime(TTime aEpocTime);
+
+ OS_IMPORT static jstring NativeToJavaString(JNIEnv& aJni, const TDesC16& aNativeString);
+
+
+ OS_IMPORT static const TUint JavaUpperEpocTime = 14474675;
+ OS_IMPORT static const TUint JavaLowerEpocTime = 254771200;
+ OS_IMPORT static HBufC* wstringToDes(const wchar_t* cStr);
+
+ /**
+ * Create a new TDesC8 from TDesC16.
+ * Transfer the owner ship to the caller
+ * @param aSource: original descriptor
+ * @param aDestination: newly created descriptor
+ *
+ * @return TInt (length of the newly created descriptor)
+ */
+ OS_IMPORT static TInt ConvertWiderToNarrowL(const TDesC& aSource,
+ TDesC8*& aDestination);
+ /**
+ * Create a new TDesC8 from TDesC16 and leave it on the cleanup stack.
+ * Transfer the owner ship to the caller
+ * @param aSource: original descriptor
+ * @param aDestination: newly created descriptor
+ *
+ * @return TInt (length of the newly created descriptor)
+ */
+ OS_IMPORT static TInt ConvertWiderToNarrowLC(const TDesC& aSource,
+ TDesC8*& aDestination);
+ /**
+ * Create a new TDesC16 from TDesC8.
+ * Transfer the owner ship to the caller
+ * @param aSource: original descriptor
+ * @param aDestination: newly created descriptor
+ *
+ * @return TInt (length of the newly created descriptor)
+ */
+ OS_IMPORT static TInt ConvertNarrowToWiderL(const TDesC8& aSource,
+ TDesC*& aDestination);
+ /**
+ * Create a new TDesC16 from TDesC8 and leave it on the cleanup stack.
+ * Transfer the owner ship to the caller
+ * @param aSource: original descriptor
+ * @param aDestination: newly created descriptor
+ *
+ * @return TInt (length of the newly created descriptor)
+ */
+ OS_IMPORT static TInt ConvertNarrowToWiderLC(const TDesC8& aSource,
+ TDesC*& aDestination);
+ /**
+ * Create the copy of TDesC8 and leave it on cleanup stack.
+ * Transfer the owner ship to the caller
+ * @param aSource: original descriptor
+ * @param aDestination: newly created descriptor
+ *
+ * @return TInt (length of the newly created descriptor)
+ */
+ OS_IMPORT static TInt CopyNarrowLC(const TDesC8& aSource,
+ TDesC8*& aDestination);
+ /**
+ * Create the copy of TDesC8.
+ * Transfer the owner ship to the caller
+ * @param aSource: original descriptor
+ * @param aDestination: newly created descriptor
+ *
+ * @return TInt (length of the newly created descriptor)
+ */
+ OS_IMPORT static TInt CopyNarrowL(const TDesC8& aSource,
+ TDesC8*& aDestination);
+ /**
+ * Create the copy of TDesC16 and leave it on cleanup stack.
+ * Transfer the owner ship to the caller
+ * @param aSource: original descriptor
+ * @param aDestination: newly created descriptor
+ *
+ * @return TInt (length of the newly created descriptor)
+ */
+ OS_IMPORT static TInt CopyWiderLC(const TDesC16& aSource,
+ TDesC16*& aDestination);
+ /**
+ * Create the copy of TDesC16.
+ * Transfer the owner ship to the caller
+ * @param aSource: original descriptor
+ * @param aDestination: newly created descriptor
+ *
+ * @return TInt (length of the newly created descriptor)
+ */
+ OS_IMPORT static TInt CopyWiderL(const TDesC16& aSource,
+ TDesC16*& aDestination);
+
+ /**
+ * Searches for the most appropriate variant of the resource corresponding
+ * to the device's language in use. The variant is searched on following
+ * drives:
+ * - on drive from where the calling dll is loaded (might be c: drive)
+ * - on ROM drive (z:)
+ *
+ * @param aResourceFileName Path name of the resource file to be matched.
+ * The path name is relative to 'resource/java' directory.
+ * E.g. providing a path name 'lcdui.rsc' the
+ * method would return either 'c:/resource/java/lcdui.rsc'
+ * or 'z:/resource/java/lcdui.rsc'
+ * @return The full name (including path) of the most appropriate
+ * variant of the resource
+ */
+ OS_IMPORT static TFileName ResourceLanguageFileNameL(const TDesC& aResourceFileName);
+
+
+ /**
+ * Searches for the specified file from several drives
+ * - on EDefaultSystem (usually C:)
+ * - on ROM drive (Z:)
+ *
+ * @param aFileName The path name (with or without drive) of the file to be searched,
+ * for example '/resource/java/java_app.mif' or 'Z:/resource/java/version.txt'
+ * @return The full name (including drive) of the first found version of the file.
+ * @throws Leaves with KErrNotFound if file does not exist in any drive
+ */
+ OS_IMPORT static TFileName VerifiedFileNameL(const TDesC& aFileName);
+
+};
+
+
+} //end namespace util
+} //end namespace java
+
+#endif // S60COMMONUTILS_H