--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javaextensions/satsa/framework/inc/satsajnitools.h Tue Apr 27 16:30:29 2010 +0300
@@ -0,0 +1,83 @@
+/*
+* 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:
+*
+*/
+
+
+
+// INCLUDE FILES
+#include <jutils.h>
+
+/*
+ * The following macro makes it possible to transfer data from a descriptor
+ * to a java byte array
+ */
+#define JAVA_PTR(aPtr) reinterpret_cast< jbyte * >( const_cast< unsigned char * >( aPtr ) )
+
+
+/**
+* Sets an error code to the first element of given Java int array.
+*
+* @param aJniEnv Pointer to JNI environment.
+* @param aErrorTo Java int array, where to put the error code.
+* @param aErrorFrom Error code.
+*
+* @par Notes:
+* @li The function panics if the array does not have at least one element.
+*/
+void STSSetJavaErrorCode(
+ JNIEnv* aJniEnv,
+ jintArray aErrorTo,
+ const TInt& aErrorFrom);
+
+/**
+ * Creates a java string array to a native string array.
+ *
+ * @param aJniEnv JNI environment.
+ * @param aJavaArray Java string array.
+ *
+ * @return Native string array, elements converted from \a aJavaArray.
+ *
+ * @par Notes:
+ * @li It is assumed that the object array contains only jstring objects.
+ * Object type is \b not checked.
+ *
+ * @par Leaving:
+ * @li Any - internal error (probably OOM).
+ */
+CDesCArrayFlat* STSCreateNativeStringArrayL(
+ JNIEnv* aJniEnv,
+ jobjectArray aJavaArray);
+
+
+/**
+ * Creates Java string array from native string array.
+ *
+ * @param aJniEnv JNI environment.
+ * @param aNativeArray Native string array.
+ * @param aConvertPIMNullArrayElements If ETrue, KPIMNullArrayElement
+ * elements are converted to NULL elements; otherwise they
+ * are not handled specially.
+ *
+ * @return Java string array, elements converted from \a aNativeArray
+ * or NULL on error (probably OOM).
+ */
+jobjectArray CreateJavaStringArray(
+ JNIEnv* aJniEnv,
+ const CDesCArray& aNativeArray,
+ TBool aConvertPIMNullArrayElements);
+
+// End of File
+