在Windows搭建Java开发环境并调用通义千问等API - Alibaba Cloud SDK

Topik ini menjelaskan cara membangun lingkungan pengembangan Java di sistem operasi Windows. Contoh berikut menggunakan IntelliJ IDEA.

Apa itu lingkungan pengembangan Java?

Lingkungan pengembangan Java adalah kumpulan konfigurasi dan alat yang digunakan untuk mengembangkan proyek Java. Ini mencakup Java Development Kit (JDK), lingkungan pengembangan terintegrasi (IDE) seperti IntelliJ IDEA, Eclipse, dan VSCode, serta alat pembuatan seperti Maven.

Instal JDK

Untuk informasi lebih lanjut, lihat Instal JDK di Windows.

Instal IDE

Dalam contoh ini, IntelliJ IDEA Community telah diinstal. Untuk mengunduh IntelliJ IDEA Community, kunjungi Halaman Unduhan IntelliJ IDEA Community dan klik tombol Unduh. Setelah pengunduhan selesai, instal sesuai petunjuk yang diberikan.

Penting

Saat menginstal IntelliJ IDEA Community, pilih Tambahkan folder "bin" ke PATH pada langkah Opsi Instalasi. Pada langkah lainnya, klik Berikutnya.

Buat proyek Maven

Buka IntelliJ IDEA dan klik Proyek Baru.
IntelliJ IDEA adalah JDE yang menyediakan berbagai fitur untuk membantu Anda mengompilasi, menguji, membangun, menjalankan, dan menerapkan proyek. IDE ini memfasilitasi manajemen dan pemeliharaan aplikasi perangkat lunak bagi pengembang.
Di panel navigasi sisi kiri jendela Proyek Baru, klik Java dan konfigurasikan parameter berikut di bagian kanan:
Nama: Nama proyek. Dalam contoh ini, helloaliyun digunakan.
Lokasi: Jalur ke file proyek.
Sistem Pembuatan: Jenis proyek. Jika Anda memilih Maven, proyek Maven dibuat.
JDK: Versi JDK. Dalam contoh ini, JDK 8 dipilih.
Catatan
Untuk memilih JDK, klik Tambah JDK, pilih JDK yang telah diinstal, lalu tentukan direktori tempat JDK diinstal.
Tambahkan Kode Sampel: Menentukan apakah akan menambahkan kode sampel. Jika Anda mencentang kotak, kelas Utama dibuat.
Klik Buat.
Proyek bernama helloaliyun kemudian dibuat. Proyek tersebut berisi file pom.xml, direktori src/main/java, dan kelas Utama.
Periksa apakah lingkungan pengembangan Java telah dibangun.
Di direktori src/main/java proyek, temukan kelas Utama di paket org.example, klik dua kali nama kelas untuk membuka file, lalu klik ikon Jalankan di pojok kanan atas.
Periksa apakah output Hello World! ditampilkan di konsol. Jika output ditampilkan, lingkungan pengembangan Java telah berhasil dibangun di Windows.

Apa yang harus dilakukan selanjutnya

Setelah membangun lingkungan pengembangan Java, Anda dapat menggunakannya dalam skenario pengembangan aktual. Berikut adalah beberapa contoh dan panduan pengguna:

1. Gunakan SDK untuk Java untuk Memanggil API Alibaba Cloud

Sebelum melakukan panggilan, Anda perlu mendapatkan pasangan AccessKey sebagai kredensial akses. Kami merekomendasikan menggunakan pasangan AccessKey dari Pengguna Resource Access Management (RAM). Untuk informasi lebih lanjut, lihat Buat Pasangan AccessKey.
Penting
Setelah mendapatkan pasangan AccessKey dari pengguna RAM, tentukan pasangan tersebut dalam variabel lingkungan. Untuk informasi lebih lanjut, lihat Konfigurasikan Variabel Lingkungan di Linux, macOS, dan Windows.
Masuk ke Pusat SDK, dan pilih layanan yang ingin Anda gunakan, seperti Operasi API DescribeInstanceTypeFamilies dari Elastic Compute Service (ECS).
Di tab Parameters di tengah halaman, konfigurasikan parameter yang diperlukan. Anda dapat merujuk ke tab Document di sebelah kanan untuk mempelajari deskripsi dan catatan penggunaan operasi tersebut, termasuk aturan penagihan serta definisi dan penggunaan setiap parameter. Sebagai contoh, operasi DescribeInstanceTypeFamilies mendukung dua parameter: RegionId (wajib, misalnya cn-qingdao) dan Generation (opsional, misalnya ecs-5). Masukkan nilai parameter dalam format yang diberikan dalam contoh.
Di tab SDK Sample Code di sebelah kanan halaman, pilih bahasa Java, klik Download Project untuk mengunduh proyek SDK lengkap ke mesin lokal Anda, lalu ekstrak proyek tersebut.

Contoh kode:

import com.aliyun.ecs20140526.Client;
import com.aliyun.ecs20140526.models.DescribeInstanceTypeFamiliesRequest;
import com.aliyun.ecs20140526.models.DescribeInstanceTypeFamiliesResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.teaopenapi.models.Config;
import com.google.gson.Gson;

public class Sample {
    public static void main(String[] args) {
        try {
            Config config = new Config()
                    // System.getenv menunjukkan bahwa kunci diperoleh dari variabel lingkungan.
                    .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                    .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
            config.endpoint = "ecs-cn-hangzhou.aliyuncs.com";
            Client client = new Client(config);
            DescribeInstanceTypeFamiliesRequest describeInstanceTypeFamiliesRequest = new DescribeInstanceTypeFamiliesRequest();
            describeInstanceTypeFamiliesRequest.setRegionId("cn-qingdao");
            describeInstanceTypeFamiliesRequest.setGeneration("ecs-5");
            DescribeInstanceTypeFamiliesResponse describeInstanceTypeFamiliesResponse = client.describeInstanceTypeFamilies(describeInstanceTypeFamiliesRequest);
            System.out.println(new Gson().toJson(describeInstanceTypeFamiliesResponse));
        } catch (TeaException teaException) {
            // Tampilkan kode kesalahan.
            System.out.println(teaException.getCode());
            // Tampilkan pesan kesalahan yang berisi ID permintaan.
            System.out.println(teaException.getMessage());
            // Tampilkan informasi kesalahan terperinci yang dikembalikan oleh server.
            System.out.println(teaException.getData());
        } catch (Exception e) {
            TeaException error = new TeaException(e.getMessage(), e);
            // Pesan kesalahan.
            System.out.println(error.getMessage());
            // URL untuk pemecahan masalah.
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        }
    }
}

Hasil yang diharapkan:
Untuk informasi lebih lanjut tentang cara menggunakan Alibaba Cloud SDK for Java untuk memanggil API Alibaba Cloud, lihat Gunakan Alibaba Cloud SDK for Java di IDE.

2. Panggil API Qwen untuk Memulai Percakapan

Alibaba Cloud Model Studio memungkinkan Anda menggunakan model besar dengan memanggil API, baik melalui API Explorer maupun DashScope SDK. Sebelum memanggil layanan tersebut, Anda perlu mengaktifkan Alibaba Cloud Model Studio dan mendapatkan Kunci API. Untuk informasi lebih lanjut, lihat bagian "Kelola Akun" di Lakukan Panggilan API Pertama Anda ke Qwen.
Penting
Setelah mendapatkan Kunci API, tentukan dalam variabel lingkungan untuk mencegah kebocoran kunci API. Jangan paparkan Kunci API di dalam kode. Untuk informasi lebih lanjut, lihat bagian "Atur Kunci API dalam Variabel Lingkungan" di Lakukan Panggilan API Pertama Anda ke Qwen.

Tambahkan dependensi berikut ke file pom.xml untuk menginstal SDK for Java:

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>dashscope-sdk-java</artifactId>
    <!-- Ganti 'the-latest-version' dengan nomor versi terbaru yang diperoleh dari https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
    <version>the-latest-version</version>
</dependency>

Setelah menginstal Java dan SDK for Java, Anda dapat menjalankan kode sampel berikut untuk memanggil API Qwen:

package org.example.nlp.ai;
import java.util.Arrays;
import java.lang.System;
import com.alibaba.dashscope.aigc.generation.Generation;
import com.alibaba.dashscope.aigc.generation.GenerationParam;
import com.alibaba.dashscope.aigc.generation.GenerationResult;
import com.alibaba.dashscope.common.Message;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
public class Sample {
    public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
        Generation gen = new Generation();
        Message systemMsg = Message.builder()
                .role(Role.SYSTEM.getValue())
                .content("You are a helpful assistant.")
                .build();
        Message userMsg = Message.builder()
                .role(Role.USER.getValue())
                .content("Who are you?")
                .build();
        GenerationParam param = GenerationParam.builder()
                // System.getenv menunjukkan bahwa kunci API diperoleh dari variabel lingkungan. Jika tidak ada variabel lingkungan yang dikonfigurasi, ganti baris berikut dengan: api_key="sk-xxx" menggunakan Kunci API Alibaba Cloud Model Studio Anda.
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .model("qwen-plus")
                .messages(Arrays.asList(systemMsg, userMsg))
                .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                .build();
        return gen.call(param);
    }
    public static void main(String[] args) {
        try {
            GenerationResult result = callWithMessage();
            System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent());
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.err.println("Pesan kesalahan:"+e.getMessage());
        }
        System.exit(0);
    }
}

Output yang diharapkan:
Untuk informasi lebih lanjut tentang cara memanggil API Qwen, lihat tab Java di bagian "Pilih Bahasa Pengembangan" di OpenAI Java SDK.

3. Panggil API DeepSeek

Bagian ini menjelaskan cara memanggil model DeepSeek menggunakan operasi API di platform Alibaba Cloud Model Studio. Model deepseek-r1 dan deepseek-v3 menyediakan satu juta token gratis. Beberapa model penyulingan gratis untuk periode waktu terbatas.

Sebelum memanggil layanan tersebut, Anda perlu mengaktifkan Alibaba Cloud Model Studio dan mendapatkan Kunci API. Untuk informasi lebih lanjut, lihat bagian "Kelola Akun" di Lakukan Panggilan API Pertama Anda ke Qwen.
Penting
Setelah mendapatkan Kunci API, tentukan dalam variabel lingkungan untuk mencegah kebocoran kunci API. Jangan paparkan Kunci API di dalam kode. Untuk informasi lebih lanjut, lihat bagian "Atur Kunci API dalam Variabel Lingkungan" di Lakukan Panggilan API Pertama Anda ke Qwen.

Tambahkan dependensi berikut ke file pom.xml untuk menginstal SDK for Java:

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>dashscope-sdk-java</artifactId>
    <!-- Ganti 'the-latest-version' dengan nomor versi terbaru dari https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
    <version>the-latest-version</version>
</dependency>

Penting

Versi DashScope SDK harus 2.18.2 atau lebih baru.

Setelah menginstal Java dan SDK for Java, Anda dapat menjalankan kode sampel berikut untuk memanggil layanan model DeepSeek:

import java.util.Arrays;
import java.lang.System;
import com.alibaba.dashscope.aigc.generation.Generation;
import com.alibaba.dashscope.aigc.generation.GenerationParam;
import com.alibaba.dashscope.aigc.generation.GenerationResult;
import com.alibaba.dashscope.common.Message;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;


public class Sample {
    public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
        Generation gen = new Generation();
        Message userMsg = Message.builder()
                .role(Role.USER.getValue())
                .content("Mana yang lebih besar, 9.9 atau 9.11?")
                .build();
        GenerationParam param = GenerationParam.builder()
                // Jika tidak ada variabel lingkungan yang dikonfigurasi, ganti baris berikut dengan: .apiKey("sk-xxx") menggunakan Kunci API Alibaba Cloud Model Studio Anda.
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .model("deepseek-r1")
                .messages(Arrays.asList(userMsg))
                // Jangan atur nilainya menjadi teks.
                .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                .build();
        return gen.call(param);
    }
    public static void main(String[] args) {
        try {
            GenerationResult result = callWithMessage();
            System.out.println("Proses berpikir:");
            System.out.println(result.getOutput().getChoices().get(0).getMessage().getReasoningContent());
            System.out.println("Jawaban akhir:");
            System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent());
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            // Gunakan kerangka logging untuk mencatat informasi pengecualian.
            System.err.println("Terjadi kesalahan saat memanggil layanan generasi: " + e.getMessage());
        }
        System.exit(0);
    }
}

Output yang diharapkan: