Tecnologia

Sem JNI e sem cola em C: como um programa Java lê e grava jsonW pela FFM

Desde o JDK 22, o Java chama bibliotecas nativas pela Foreign Function and Memory API, sem a ponte JNI. O SDK do jsonW usa esse caminho para ler e gravar arquivos .jsw por cima da ABI C. Veja o que muda para quem decide e o que ainda não foi medido.

Por Equipe Wortic 8 min de leitura Atualizado em 14 de novembro de 2026
Sem JNI e sem cola em C: como um programa Java lê e grava jsonW pela FFM

O fato: a API nativa do Java saiu do modo de teste

Nas fontes consultadas, não há notícia sobre essa API nas últimas 48 horas. O fato com data mais útil para quem decide tecnologia vem do blog oficial da linguagem. Em 12 de junho de 2025, o Inside.java registrou que a Foreign Function and Memory API foi finalizada no Java 22 e permite acessar memória nativa e chamar funções nativas diretamente do Java.

Em 12 de maio de 2026, o mesmo blog voltou ao tema com um texto de Per-Ake Minborg sobre a interoperabilidade nativa com o JDK 25. Segundo o texto, a API evita o processo de JNI e ByteBuffers que a equipe descreve como lento, frágil e complexo, e o JDK 25 aparece como a versão com suporte de longo prazo para ela.

O que muda na prática para quem decide

Na prática, o time que mantém o programa em Java deixa de precisar de uma camada de código escrita dos dois lados da fronteira. A leitura da Wortic é que isso reduz o número de pontos a revisar quando a biblioteca nativa muda de versão.

O jsonW não cria esse caminho sozinho. O README lista, na tabela de SDKs, o Java 22 ou superior com o arquivo sdk/java/Jsonw.java, usando FFM e sem JNI, e as classes Jsonw.Leitor e Jsonw.Escritor. Todos os SDKs ficam por cima da mesma ABI C estável, a libjsonw.

O fluxo, do programa ao arquivo

Cada chamada feita pelo programa Java passa pelo SDK, que usa a FFM para chegar à biblioteca em C. Essa biblioteca lê ou grava o arquivo .jsw. O diagrama mostra o caminho de ida e volta.

flowchart LR
  A[Programa Java 22+] --> B[Jsonw.java via FFM]
  B --> C[libjsonw, ABI C]
  C --> D[(arquivo .jsw)]
  D --> C
  C --> B
  B --> A
sequenceDiagram
  participant App as Programa Java
  participant SDK as Jsonw.Leitor
  participant Lib as libjsonw
  App ->> SDK: new Leitor("dados.jsw")
  SDK ->> Lib: jsonw_abrir via FFM
  Lib ->> SDK: handle do arquivo
  App ->> SDK: json(i)
  SDK ->> Lib: jsonw_linha_json
  Lib ->> SDK: linha em JSON

Um exemplo tirado do repositório

O cabeçalho do arquivo sdk/java/Jsonw.java mostra a leitura e a gravação em duas linhas cada. Esse trecho vem do próprio repositório, sem alteração:

try (var a = new Jsonw.Leitor("dados.jsw")) {
    for (long i = 0; i < a.linhas; i++) System.out.println(a.json(i));
}

try (var w = new Jsonw.Escritor("novo.jsw", "id:i64,nome:texto")) {
    w.gravar("{\"id\":1,\"nome\":\"x\"}");
}

O mesmo cabeçalho indica o comando para rodar o arquivo: java --enable-native-access=ALL-UNNAMED Jsonw.java arquivo.jsw, com a libjsonw na pasta sdk ou com o caminho completo na variável JSONW_LIB.

Ganho de espaço e de velocidade, com os limites da medição

Os números do projeto são estes: arquivo 4,9 vezes menor que o JSONL e leitura de um campo 3.281 vezes mais rápida, em 100 mil registros, segundo a medição do próprio projeto. A comparação é com o JSONL lido pelo leitor do jsonW. Não há medição publicada do SDK em Java, nem de memória, de rede ou de custo de servidor.

A segurança também tem preço. A Inside.java mediu que uma leitura ou escrita pela FFM fica quase três vezes mais lenta que pelo Unsafe, porque a API confere limites, tempo de vida, alinhamento e permissão de leitura. O mesmo texto afirma que, em padrões de acesso imprevisíveis, como buscas binárias, a vetorização automática pode compensar esse custo.

Comparação honesta com o que se usa hoje

Quem usa JNI hoje precisa manter código em C junto do Java, além de recompilar a camada nativa quando a biblioteca muda. Com a FFM, a equipe Java chama a biblioteca diretamente, mas precisa liberar o acesso nativo com a flag mostrada acima. Quem já tem um leitor de JSON em Java e um pipeline estável talvez não ganhe muito; o ganho aparece quando o arquivo é grande e lido com frequência.

Passo a passo para testar em uma semana

  1. Confirme que a equipe usa Java 22 ou superior. O README pede essa versão para o SDK.
  2. Pegue o pacote com a libjsonw da sua plataforma, na pasta bin/, ou aponte o caminho completo em JSONW_LIB.
  3. Rode o programa com --enable-native-access=ALL-UNNAMED. Sem a flag, o acesso nativo não é liberado.
  4. Leia uma amostra do arquivo e chame conferir() antes de usar os dados, para confirmar que o arquivo passa na verificação.
  5. Meça no próprio servidor, com o arquivo e o padrão de leitura reais, e compare com a leitura atual. Anote tempo, memória e uso de disco.

Três situações do dia a dia (hipotéticas)

Situação 1: uma equipe de integração recebe, toda noite, um arquivo de pedidos de vários clientes. Hoje, o programa Java carrega o JSON inteiro antes de filtrar. O que fazer: trocar a leitura por Jsonw.Leitor e ler só o campo de que precisa, com campo(i, k). Resultado esperado: menos memória ocupada durante o filtro, a ser confirmado com medição no próprio servidor.

Situação 2: um serviço Java atende várias empresas a partir do mesmo arquivo. O que fazer: abrir o leitor com visao("tenant:42"), para que a sessão veja só as linhas dela. Resultado esperado: uma linha de outra empresa gera a exceção LinhaOculta, em vez de vazar dado.

Situação 3: o time de dados precisa provar que o arquivo de auditoria não foi alterado antes de uma análise. O que fazer: rodar conferir() logo após abrir o arquivo e guardar o resultado no registro da rotina. Resultado esperado: uma falha de verificação aparece antes do relatório, não depois.

Perguntas frequentes

O jsonW funciona com Java 22?

Sim, segundo o README, que lista o SDK Java para a versão 22 ou superior. A Wortic indica o arquivo sdk/java/Jsonw.java como ponto de partida.

Preciso escrever código em C para usar o jsonW no Java?

Não para o SDK Java. Ele usa a FFM e chama a libjsonw, que já é a ABI C publicada pelo projeto.

Por que o comando tem a flag --enable-native-access?

O cabeçalho do arquivo mostra essa flag no comando de execução. Sem ela, o programa não libera o acesso à biblioteca nativa.

O jsonW é mais rápido que o JSON em Java?

O projeto mediu arquivo 4,9 vezes menor e leitura de um campo 3.281 vezes mais rápida, contra o JSONL, em 100 mil registros. Não há medição publicada do SDK Java contra o JSON da própria JVM.

Quanto de memória o SDK Java economiza?

O README não traz medição de memória para Java. A resposta correta, hoje, é medir no seu caso.

O Java 25 já tem essa API?

Segundo o Inside.java, em texto de 12 de maio de 2026, o JDK 25 é a versão com suporte de longo prazo para a FFM.

Onde está o código do SDK?

No repositório developer-wortic/jsonw, e a visão geral do formato está em jsonw.org.

Fontes

Links para o jsonW: jsonw.org e repositório no GitHub.

Perguntas frequentes

O jsonW funciona com Java 22?

Sim. O README lista o SDK Java para a versão 22 ou superior, em sdk/java/Jsonw.java, usando a FFM e sem JNI.

Preciso escrever código em C para usar o jsonW no Java?

Não para o SDK Java. Ele chama a libjsonw, que é a ABI C publicada pelo projeto, pela Foreign Function and Memory API.

Por que o comando de execução tem a flag --enable-native-access?

O cabeçalho do arquivo Jsonw.java mostra essa flag no comando. Sem ela, o programa não libera o acesso à biblioteca nativa.

O jsonW é mais rápido que o JSON em Java?

O projeto mediu arquivo 4,9 vezes menor e leitura de um campo 3.281 vezes mais rápida, contra o JSONL, em 100 mil registros. Não há medição publicada do SDK Java.

Quanto de memória o SDK Java economiza?

O README não traz medição de memória para Java. O caminho é medir no próprio servidor, com o arquivo e o padrão de leitura reais.

O Java 25 já tem essa API?

Segundo o Inside.java, em texto de 12 de maio de 2026, o JDK 25 aparece como a versão com suporte de longo prazo para a FFM.

Onde está o código do SDK Java?

No repositório developer-wortic/jsonw, no caminho sdk/java. A visão geral do formato e dos SDKs está em jsonw.org.

Fontes

Conheça: jsonW em Java 22+ sem JNI.

Quer isso funcionando na sua empresa?

Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.

Falar com um consultor

Equipe editorial

Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.

  • Automacao com IA
  • Gestao empresarial
  • CRM
  • ERP
  • Marketing digital

Isso funcionando no seu negócio.

Um consultor mostra o sistema do seu ramo, com a IA dentro.