1# Blob Storage — Java SDK Quick Reference
2 
3> Condensed from **azure-storage-blob-java**. Full patterns (SAS tokens,
4> streaming, lease management, parallel uploads, proxy config)
5> in the **azure-storage-blob-java** plugin skill if installed.
6 
7## Install
8```xml
9<dependency>
10    <groupId>com.azure</groupId>
11    <artifactId>azure-storage-blob</artifactId>
12    <version>12.33.0</version>
13</dependency>
14<dependency>
15    <groupId>com.azure</groupId>
16    <artifactId>azure-identity</artifactId>
17</dependency>
18```
19 
20## Quick Start
21```java
22import com.azure.storage.blob.BlobServiceClientBuilder;
23import com.azure.identity.DefaultAzureCredentialBuilder;
24var serviceClient = new BlobServiceClientBuilder()
25    .endpoint("<storage-account-url>")
26    .credential(new DefaultAzureCredentialBuilder().build())
27    .buildClient();
28```
29 
30## Best Practices
31- Use DefaultAzureCredential for **local development only** — in production, use ManagedIdentityCredential. See [auth-best-practices.md](../auth-best-practices.md)
32- Use `BinaryData.fromString()` for string uploads
33- Use `createIfNotExists()` for idempotent container creation
34- Use `BlobParallelUploadOptions` for large file uploads with headers/metadata
35- Use `BlobInputStream`/`BlobOutputStream` for streaming large blobs
36- Handle `BlobStorageException` — check `getStatusCode()` and `getErrorCode()`
37