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.

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
- Confirme que a equipe usa Java 22 ou superior. O README pede essa versão para o SDK.
- Pegue o pacote com a
libjsonwda sua plataforma, na pastabin/, ou aponte o caminho completo emJSONW_LIB. - Rode o programa com
--enable-native-access=ALL-UNNAMED. Sem a flag, o acesso nativo não é liberado. - Leia uma amostra do arquivo e chame
conferir()antes de usar os dados, para confirmar que o arquivo passa na verificação. - 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
- Inside.java: FFM vs. Unsafe, 12/06/2025
- Inside.java: Native Interoperability with JDK 25 and the FFM API, 12/05/2026
- Repositório jsonW (README, AGENTS.md e sdk/java)
- sdk/java/Jsonw.java
- jsonw.org
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
- Inside.java: FFM vs. Unsafe, 12/06/2025
- Inside.java: Native Interoperability with JDK 25 and the FFM API, 12/05/2026
- Repositório jsonW
- sdk/java/Jsonw.java
- jsonW
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 consultorEquipe editorial
Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.
- Automacao com IA
- Gestao empresarial
- CRM
- ERP
- Marketing digital

