For the complete documentation index, see llms.txt. This page is also available as Markdown.

Java

Instale e gerencie um JDK Java localmente (Windows, macOS, Linux) usando instaladores, gerenciadores de pacotes ou SDKMAN!; gere um JAR executável com Maven ou Gradle.

🧾 Visão Geral

Java roda na JVM e é usado em bots do Discord (JDA, Discord4J), APIs (Spring Boot, Javalin) e serviços em segundo plano. Um JDK local permite:

  • Compilar e executar seu projeto antes de fazer o upload na Discloud

  • Gerenciar dependências com Maven ou Gradle

  • Gerar o .jar executável que você envia para a Discloud

Na Discloud, aplicações Java são enviadas como um .jar já compilado. Veja Java para os detalhes de hospedagem e Como construir e empacotar uma aplicação Java? para o passo a passo completo do build.


📥 Instalação

Instale um JDK (não apenas um JRE): o JDK inclui o compilador javac. Os exemplos abaixo usam o Eclipse Temurin, um build gratuito do OpenJDK. Escolha uma versão LTS (ex.: 21).

1

Abra https://adoptium.net/ e baixe o instalador .msi LTS

2

Execute o instalador e ative Set JAVA_HOME variable e Add to PATH

3

Reabra o terminal e verifique

Baixe o .pkg LTS em adoptium.net, instale e depois:


🧰 Ferramentas de Build (Maven ou Gradle)

A maioria dos projetos Java usa uma ferramenta de build para baixar as dependências e gerar o .jar. Use a que o seu projeto já tem (pom.xml = Maven, build.gradle = Gradle).

Se o projeto tiver o Gradle wrapper (gradlew), você não precisa instalar o Gradle: use ./gradlew (ou gradlew.bat no Windows).


🧪 Fluxo Mínimo

1

Gere o JAR do projeto

2

Teste o JAR localmente antes de enviar

3

Envie o .jar para a Discloud, com o MAIN do seu discloud.config apontando para ele.

O nome e a pasta do JAR (target/ no Maven, build/libs/ no Gradle) dependem do seu projeto. Para incluir as dependências em um único JAR executável, veja Como construir e empacotar uma aplicação Java?.


🔄 Atualização

Tarefa
Comando

Atualizar o JDK (SDKMAN!)

sdk upgrade java

Atualizar o JDK (Homebrew)

brew upgrade --cask temurin@21

Atualizar o JDK (winget)

winget upgrade EclipseAdoptium.Temurin.21.JDK

Verificar atualizações de deps (Maven)

mvn versions:display-dependency-updates


🗃 Comandos Comuns