К основному содержанию
скилл CX Codex

azure-eventgrid-java — скилл для Claude Code: обзор и установка

Скилл azure-eventgrid-java помогает проектировать событийную архитектуру на Java с библиотекой azure-messaging-eventgrid. Полезен при публикации сообщений в Event Grid и интеграции вебхуков.

MIT ★ 3 232 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add microsoft/skills --skill azure-eventgrid-java -a claude-code
Открыть на GitHub

Что делает azure-eventgrid-java

Скилл обучает ассистента работать с библиотекой com.azure:azure-messaging-eventgrid версии 4.27.0. Внутри собраны готовые шаблоны для создания EventGridPublisherClient и его асинхронной версии EventGridPublisherAsyncClient. Они помогают наладить отправку одиночных сообщений или пакетов данных.

Код покрывает как родной формат EventGridEvent, так и спецификацию CNCF CloudEvents 1.0. Кроме публикации, примеры показывают разбор входящего JSON из вебхуков, включая системные события вроде Microsoft.Storage.BlobCreated.

Для локальной аутентификации через DefaultAzureCredentialBuilder потребуется заранее задать переменную окружения AZURE_TOKEN_CREDENTIALS.

Какие задачи решает

  • настроить синхронный или асинхронный EventGridPublisherClient
  • отправить партии событий в форматах CloudEvent и EventGridEvent
  • подключить авторизацию через AzureKeyCredential или DefaultAzureCredential
  • распарсить входящие вебхуки с событиями Microsoft.Storage.BlobCreated

Примеры запросов агенту

  • Напиши класс на Java для отправки CloudEvent в Azure Event Grid через асинхронный клиент
  • Покажи, как распарсить входящий JSON вебхука в список объектов EventGridEvent
  • Сконфигурируй EventGridPublisherClient с авторизацией через DefaultAzureCredential

Как установить azure-eventgrid-java

1Через Skills CLI (Vercel)

npx skills add microsoft/skills --skill azure-eventgrid-java -a claude-code

2Вручную: положить файлы

~/.claude/skills/azure-eventgrid-java/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/azure-eventgrid-java/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об azure-eventgrid-java

Как установить azure-eventgrid-java в Claude Code?

Для установки выполните команду npx skills add microsoft/skills --skill azure-eventgrid-java -a claude-code.

Какие форматы событий поддерживает azure-eventgrid-java?

Скилл содержит примеры для собственной схемы EventGridEvent, спецификации CloudEvents 1.0 и произвольных структур через BinaryData.

Как авторизовать клиент Event Grid?

Можно применить прямой API-ключ через AzureKeyCredential либо настроить токены через DefaultAzureCredentialBuilder с переменной AZURE_TOKEN_CREDENTIALS.

Исходный текст

SKILL.md · MIT
---
name: azure-eventgrid-java
description: Build event-driven applications with Azure Event Grid SDK for Java. Use when publishing events, implementing pub/sub patterns, or integrating with Azure services via events.
license: MIT
metadata:
  author: Microsoft
  version: "1.0.0"
  package: com.azure:azure-messaging-eventgrid
---

# Azure Event Grid SDK for Java

Build event-driven applications using the Azure Event Grid SDK for Java.

## Installation

```xml
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-messaging-eventgrid</artifactId>
    <version>4.27.0</version>
</dependency>
```

## Client Creation

### EventGridPublisherClient

```java
import com.azure.messaging.eventgrid.EventGridPublisherClient;
import com.azure.messaging.eventgrid.EventGridPublisherClientBuilder;
import com.azure.core.credential.AzureKeyCredential;

// With API Key
EventGridPublisherClient<EventGridEvent> client = new EventGridPublisherClientBuilder()
    .endpoint("<topic-endpoint>")
    .credential(new AzureKeyCredential("<access-key>"))
    .buildEventGridEventPublisherClient();

// For CloudEvents
EventGridPublisherClient<CloudEvent> cloudClient = new EventGridPublisherClientBuilder()
    .endpoint("<topic-endpoint>")
    .credential(new AzureKeyCredential("<access-key>"))
    .buildCloudEventPublisherClient();
```

### With DefaultAzureCredential

```java
import com.azure.core.credential.TokenCredential;
import com.azure.identity.AzureIdentityEnvVars;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.identity.ManagedIdentityCredentialBuilder;

// Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>
TokenCredential credential = new DefaultAzureCredentialBuilder()
    .requireEnvVars(AzureIdentityEnvVars.AZURE_TOKEN_CREDENTIALS)
    .build();
// Or use a specific credential directly in production:
// See https://learn.microsoft.com/java/api/overview/azure/identity-readme?view=azure-java-stable#credential-classes
// TokenCredential credential = new ManagedIdentityCredentialBuilder().build();

EventGridPublisherClient<EventGridEvent> client = new EventGridPublisherClientBuilder()
    .endpoint("<topic-endpoint>")
    .credential(credential)
    .buildEventGridEventPublisherClient();
```

### Async Client

```java
import com.azure.messaging.eventgrid.EventGridPublisherAsyncClient;

EventGridPublisherAsyncClient<EventGridEvent> asyncClient = new EventGridPublisherClientBuilder()
    .endpoint("<topic-endpoint>")
    .credential(new AzureKeyCredential("<access-key>"))
    .buildEventGridEventPublisherAsyncClient();
```

## Event Types

| Type | Description |
|------|-------------|
| `EventGridEvent` | Azure Event Grid native schema |
| `CloudEvent` | CNCF CloudEvents 1.0 specification |
| `BinaryData` | Custom schema events |

## Core Patterns

### Publish EventGridEvent

```java
import com.azure.messaging.eventgrid.EventGridEvent;
import com.azure.core.util.BinaryData;

EventGridEvent event = new EventGridEvent(
    "resource/path",           // subject
    "MyApp.Events.OrderCreated", // eventType
    BinaryData.fromObject(new OrderData("order-123", 99.99)), // data
    "1.0"                      // dataVersion
);

client.sendEvent(event);
```

### Publish Multiple Events

```java
List<EventGridEvent> events = Arrays.asList(
    new EventGridEvent("orders/1", "Order.Created", 
        BinaryData.fromObject(order1), "1.0"),
    new EventGridEvent("orders/2", "Order.Created", 
        BinaryData.fromObject(order2), "1.0")
);

client.sendEvents(events);
```

### Publish CloudEvent

```java
import com.azure.core.models.CloudEvent;
import com.azure.core.models.CloudEventDataFormat;

CloudEvent cloudEvent = new CloudEvent(
    "/myapp/orders",           // source
    "order.created",           // type
    BinaryData.fromObject(orderData), // data
    CloudEventDataFormat.JSON  // dataFormat
);
cloudEvent.setSubject("orders/12345");
cloudEvent.setId(UUID.randomUUID().toString());

cloudClient.sendEvent(cloudEvent);
```

### Publish CloudEvents Batch

```java
List<CloudEvent> cloudEvents = Arrays.asList(
    new CloudEvent("/app", "event.type1", BinaryData.fromString("data1"), CloudEventDataFormat.JSON),
    new CloudEvent("/app", "event.type2", BinaryData.fromString("data2"), CloudEventDataFormat.JSON)
);

cloudClient.sendEvents(cloudEvents);
```

### Async Publishing

```java
asyncClient.sendEvent(event)
    .subscribe(
        unused -> System.out.println("Event sent successfully"),
        error -> System.err.println("Error: " + error.getMessage())
    );

// With multiple events
asyncClient.sendEvents(events)
    .doOnSuccess(unused -> System.out.println("All events sent"))
    .doOnError(error -> System.err.println("Failed: " + error))
    .block(); // Block if needed
```

### Custom Event Data Class

```java
public class OrderData {
    private String orderId;
    private double amount;
    private String customerId;
    
    public OrderData(String orderId, double amount) {
        this.orderId = orderId;
        this.amount = amount;
    }
    
    // Getters and setters
}

// Usage
OrderData order = new OrderData("ORD-123", 150.00);
EventGridEvent event = new EventGridEvent(
    "orders/" + order.getOrderId(),
    "MyApp.Order.Created",
    BinaryData.fromObject(order),
    "1.0"
);
```

## Receiving Events

### Parse EventGridEvent

```java
import com.azure.messaging.eventgrid.EventGridEvent;

// From JSON string (e.g., webhook payload)
String jsonPayload = "[{\"id\": \"...\", ...}]";
List<EventGridEvent> events = EventGridEvent.fromString(jsonPayload);

for (EventGridEvent event : events) {
    System.out.println("Event Type: " + event.getEventType());
    System.out.println("Subject: " + event.getSubject());
    System.out.println("Event Time: " + event.getEventTime());
    
    // Get data
    BinaryData data = event.getData();
    OrderData orderData = data.toObject(OrderData.class);
}
```

### Parse CloudEvent

```java
import com.azure.core.models.CloudEvent;

String cloudEventJson = "[{\"specversion\": \"1.0\", ...}]";
List<CloudEvent> cloudEvents = CloudEvent.fromString(cloudEventJson);

for (CloudEvent event : cloudEvents) {
    System.out.println("Type: " + event.getType());
    System.out.println("Source: " + event.getSource());
    System.out.println("ID: " + event.getId());
    
    MyEventData data = event.getData().toObject(MyEventData.class);
}
```

### Handle System Events

```java
import com.azure.messaging.eventgrid.systemevents.*;

for (EventGridEvent event : events) {
    if (event.getEventType().equals("Microsoft.Storage.BlobCreated")) {
        StorageBlobCreatedEventData blobData = 
            event.getData().toObject(StorageBlobCreatedEventData.class);
        System.out.println("Blob URL: " + blobData.getUrl());
    }
}
```

## Event Grid Namespaces (MQTT/Pull)

### Receive from Namespace Topic

```java
import com.azure.messaging.eventgrid.namespaces.EventGridReceiverClient;
import com.azure.messaging.eventgrid.namespaces.EventGridReceiverClientBuilder;
import com.azure.messaging.eventgrid.namespaces.models.*;

EventGridReceiverClient receiverClient = new EventGridReceiverClientBuilder()
    .endpoint("<namespace-endpoint>")
    .credential(new AzureKeyCredential("<key>"))
    .topicName("my-topic")
    .subscriptionName("my-subscription")
    .buildClient();

// Receive events
ReceiveResult result = receiverClient.receive(10, Duration.ofSeconds(30));

for (ReceiveDetails detail : result.getValue()) {
    CloudEvent event = detail.getEvent();
    System.out.println("Event: " + event.getType());
    
    // Acknowledge the event
    receiverClient.acknowledge(Arrays.asList(detail.getBrokerProperties().getLockToken()));
}
```

### Reject or Release Events

```java
// Reject (don't retry)
receiverClient.reject(Arrays.asList(lockToken));

// Release (retry later)
receiverClient.release(Arrays.asList(lockToken));

// Release with delay
receiverClient.release(Arrays.asList(lockToken), 
    new ReleaseOptions().setDelay(ReleaseDelay.BY_60_SECONDS));
```

## Error Handling

```java
import com.azure.core.exception.HttpResponseException;

try {
    client.sendEvent(event);
} catch (HttpResponseException e) {
    System.out.println("Status: " + e.getResponse().getStatusCode());
    System.out.println("Error: " + e.getMessage());
}
```

## Environment Variables

```bash
EVENT_GRID_TOPIC_ENDPOINT=https://<topic-name>.<region>.eventgrid.azure.net/api/events  # Required for all auth methods
EVENT_GRID_ACCESS_KEY=<your-access-key>  # Only required for AzureKeyCredential auth
AZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production
```

## Best Practices

1. **Batch Events**: Send multiple events in one call when possible
2. **Idempotency**: Include unique event IDs for deduplication
3. **Schema Validation**: Use strongly-typed event data classes
4. **Retry Logic**: Built-in, but consider dead-letter for failures
5. **Event Size**: Keep events under 1MB (64KB for basic tier)

## Trigger Phrases

- "Event Grid Java"
- "publish events Azure"
- "CloudEvent SDK"
- "event-driven messaging"
- "pub/sub Azure"
- "webhook events"

© Microsoft · MIT · microsoft/skills

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
java-modernization-studio официальный Ayan Gupta Плагин java-modernization-studio ведёт модернизацию Java-приложений в GitHub Copilot с интерактивного холста: проверка окружения, оценка репозитория, план и контрольные точки. ★ 41 430звёзд репо aws-sdk-java-v2-rds giuseppe-trisciuoglio Скилл aws-sdk-java-v2-rds помогает управлять базами данных Amazon RDS через AWS SDK for Java 2.x. Пригодится при настройке инстансов, снэпшотов и групп параметров в коде на Java. CX Codex +1 3 900установок aws-sdk-java-v2-kms giuseppe-trisciuoglio Скилл aws-sdk-java-v2-kms для Claude Code помогает писать код для AWS KMS через AWS SDK for Java 2.x. Он включается при работе с ключами, шифрованием, подписями и интеграцией со Spring Boot. CX Codex +1 3 900установок java-quarkus-development Mindrally Скилл java-quarkus-development для Claude Code задаёт практики разработки сервисов на Java Quarkus: проектирование реактивных API, настройка Panache и подготовка нативной сборки GraalVM. CX Codex +1 884установок java-pro Seth Hobson Субагент java-pro для Claude Code помогает разрабатывать на Java и проектировать микросервисы. Подключается к задачам по Java и настройке производительности JVM. CX Codex ★ 42 780звёзд репо convert-jpa-to-spring-data-cosmos официальный github Правило convert-jpa-to-spring-data-cosmos для GitHub Copilot: переводит Spring Boot проект с JPA на Azure Cosmos DB через Spring Data Cosmos. Описывает девять шагов миграции — от замены зависимостей до переделки сущностей и тестов. CX Codex +1 ★ 41 430звёзд репо

Из того же набора250

Весь набор →
azure-monitor-ingestion-java Скилл azure-monitor-ingestion-java для Claude Code помогает подключить Java-приложение к Azure Monitor Ingestion SDK и отправлять пользовательские логи. Срабатывает при работе с LogsIngestionClient, DCR и передачей логов из Java. CX Codex +1 ★ 3 232звёзд репо azure-messaging-webpubsub-java Скилл azure-messaging-webpubsub-java обучает ИИ-агента работать с Azure Web PubSub SDK для Java: рассылать сообщения по WebSocket, фильтровать получателей и управлять клиентскими сессиями. CX Codex +1 ★ 3 232звёзд репо azure-identity-java Скилл azure-identity-java помогает подключать Java-приложения к Azure через Microsoft Entra ID. Используйте его при выборе учётных данных для Azure SDK. CX Codex +1 ★ 3 232звёзд репо azure-eventhub-java Скилл azure-eventhub-java для Claude Code помогает писать Java-код для потоковой обработки событий в Azure Event Hubs. Включается при настройке отправки и получения событий или потокового сбора данных. CX Codex +1 ★ 3 232звёзд репо azure-data-tables-java Скилл azure-data-tables-java помогает писать Java-приложения для Azure Table Storage и Cosmos DB Table API. Подсказывает, как создавать таблицы и выполнять операции с сущностями. CX Codex +1 ★ 3 232звёзд репо azure-cosmos-java Скилл azure-cosmos-java подсказывает агенту, как работать с Azure Cosmos DB из Java: клиенты, запросы, ключи разделов и обработка ошибок. CX Codex +1 ★ 3 232звёзд репо azure-compute-batch-java Скилл azure-compute-batch-java помогает писать Java-код для пакетных вычислений и HPC в Azure Batch. Подсказывает правильные вызовы SDK для пулов, задач и нод. CX Codex +1 ★ 3 232звёзд репо azure-communication-sms-java Скилл azure-communication-sms-java помогает подключить Azure Communication Services SMS Java SDK для отправки сообщений одному или нескольким получателям и обработки результатов. CX Codex +1 ★ 3 232звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой