Add Qt JNI API.
[qt:qtandroidextras.git] / src / androidextras / doc / snippets / code / src_androidextras_qjniobject.cpp
1 /****************************************************************************
2  **
3  ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
4  ** Contact: http://www.qt-project.org/legal
5  **
6  ** This file is part of the documentation of the Qt Toolkit.
7  **
8  ** $QT_BEGIN_LICENSE:BSD$
9  ** You may use this file under the terms of the BSD license as follows:
10  **
11  ** "Redistribution and use in source and binary forms, with or without
12  ** modification, are permitted provided that the following conditions are
13  ** met:
14  **   * Redistributions of source code must retain the above copyright
15  **     notice, this list of conditions and the following disclaimer.
16  **   * Redistributions in binary form must reproduce the above copyright
17  **     notice, this list of conditions and the following disclaimer in
18  **     the documentation and/or other materials provided with the
19  **     distribution.
20  **   * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names
21  **     of its contributors may be used to endorse or promote products derived
22  **     from this software without specific prior written permission.
23  **
24  **
25  ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26  ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27  ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28  ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
29  ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30  ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
31  ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
32  ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
33  ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
34  ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
35  ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
36  **
37  ** $QT_END_LICENSE$
38  **
39  ****************************************************************************/
40
41 //! [Working with lists]
42 QStringList getTrackTitles(const QJNIObject &album) {
43     QStringList stringList;
44     QJNIObject list = album.callObjectMethod<jobject>("getTitles",
45                                                       "()Ljava/util/List;");
46
47     if (list.isValid()) {
48         const int size = list.callMethod<jint>("size");
49         for (int i = 0; i < size; ++i) {
50             QJNIObject title = list.callObjectMethod<jobject>("get", "(I)Ljava/lang/Object;", i);
51             stringList.append(title.toString());
52         }
53     }
54     return stringList;
55 }
56 //! [Working with lists]
57
58 //! [QJNIObject scope]
59 void function()
60 {
61     QString helloString("Hello");
62     jstring myJString = 0;
63     {
64         QJNIObject string = QJNIObject::fromString(string);
65         myJString = string.object<jstring>();
66     }
67
68    // Ops! myJString is no longer valid.
69 }
70 //! [QJNIObject scope]