Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved.

DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

This code is free software; you can redistribute it and\\\/or modify it

under the terms of the GNU General Public License version 2 only, as

published by the Free Software Foundation.

This code is distributed in the hope that it will be useful, but WITHOUT

ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

version 2 for more details (a copy is included in the LICENSE file that

accompanied this code).

You should have received a copy of the GNU General Public License version

2 along with this work; if not, write to the Free Software Foundation,

Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

or visit www.oracle.com if you need additional information or have any

questions.

---------------------------------------------------------------------------------

This directory contains source files of testbase_nsk JNI framework,

which provides support for JNI tests and accessing JNI environment.

    Source files:

        jni_tools.h

        jni_tools.c

    Naming conventions:

        macroses:  NSK_JNI_*

        functions: nsk_JNI_*

---------------------------------------------------------------------------------

jni_tools.h

Provides functions and macroses for invocation of JNI functions

and checking JNI errors and pending exceptions:

    NSK_JNI_VERIFY(jni, action)

    NSK_JNI_VERIFY_NEGATIVE(jni, action)

Typical example of usage of NSK_JNI_VERIFY and NSK_CPP_STUB macroses

for invokation of JNI functions:

    // jni->FindClass(jni, class_name)

    if (!NSK_JNI_VERIFY(jni,

            NSK_CPP_STUB2(FindClass, jni, class_name) != NULL)) {

        return JNI_ERR;

    }

or with saving obtained data:

    // cls = jni->FindClass(jni, class_name)

    if (!NSK_JNI_VERIFY(jni, (cls =

            NSK_CPP_STUB2(FindClass, jni, class_name)) != NULL)) {

        return JNI_ERR;

    }

---------------------------------------------------------------------------------