[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-5d3ef1d9-8a0c-4584-b351-78a797f513ad":3,"$fYiRRmPhDxb_nwJ5Gz0-lMzpSPQvqXV3Iz7uiwkMCyiA":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"5d3ef1d9-8a0c-4584-b351-78a797f513ad","azure-appconfiguration-java","Azure App Configuration SDK for Java。集中式应用程序配置管理，包括键值设置、功能标志和快照。","cat_coding_devops","mod_coding","sickn33,coding","---\nname: azure-appconfiguration-java\ndescription: Azure App Configuration SDK for Java. Centralized application configuration management with key-value settings, feature flags, and snapshots.\nrisk: unknown\nsource: community\ndate_added: '2026-02-27'\n---\n\n# Azure App Configuration SDK for Java\n\nClient library for Azure App Configuration, a managed service for centralizing application configurations.\n\n## Installation\n\n```xml\n\u003Cdependency>\n    \u003CgroupId>com.azure\u003C\u002FgroupId>\n    \u003CartifactId>azure-data-appconfiguration\u003C\u002FartifactId>\n    \u003Cversion>1.8.0\u003C\u002Fversion>\n\u003C\u002Fdependency>\n```\n\nOr use Azure SDK BOM:\n\n```xml\n\u003CdependencyManagement>\n    \u003Cdependencies>\n        \u003Cdependency>\n            \u003CgroupId>com.azure\u003C\u002FgroupId>\n            \u003CartifactId>azure-sdk-bom\u003C\u002FartifactId>\n            \u003Cversion>{bom_version}\u003C\u002Fversion>\n            \u003Ctype>pom\u003C\u002Ftype>\n            \u003Cscope>import\u003C\u002Fscope>\n        \u003C\u002Fdependency>\n    \u003C\u002Fdependencies>\n\u003C\u002FdependencyManagement>\n\n\u003Cdependencies>\n    \u003Cdependency>\n        \u003CgroupId>com.azure\u003C\u002FgroupId>\n        \u003CartifactId>azure-data-appconfiguration\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n```\n\n## Prerequisites\n\n- Azure App Configuration store\n- Connection string or Entra ID credentials\n\n## Environment Variables\n\n```bash\nAZURE_APPCONFIG_CONNECTION_STRING=Endpoint=https:\u002F\u002F\u003Cstore>.azconfig.io;Id=\u003Cid>;Secret=\u003Csecret>\nAZURE_APPCONFIG_ENDPOINT=https:\u002F\u002F\u003Cstore>.azconfig.io\n```\n\n## Client Creation\n\n### With Connection String\n\n```java\nimport com.azure.data.appconfiguration.ConfigurationClient;\nimport com.azure.data.appconfiguration.ConfigurationClientBuilder;\n\nConfigurationClient configClient = new ConfigurationClientBuilder()\n    .connectionString(System.getenv(\"AZURE_APPCONFIG_CONNECTION_STRING\"))\n    .buildClient();\n```\n\n### Async Client\n\n```java\nimport com.azure.data.appconfiguration.ConfigurationAsyncClient;\n\nConfigurationAsyncClient asyncClient = new ConfigurationClientBuilder()\n    .connectionString(connectionString)\n    .buildAsyncClient();\n```\n\n### With Entra ID (Recommended)\n\n```java\nimport com.azure.identity.DefaultAzureCredentialBuilder;\n\nConfigurationClient configClient = new ConfigurationClientBuilder()\n    .credential(new DefaultAzureCredentialBuilder().build())\n    .endpoint(System.getenv(\"AZURE_APPCONFIG_ENDPOINT\"))\n    .buildClient();\n```\n\n## Key Concepts\n\n| Concept | Description |\n|---------|-------------|\n| Configuration Setting | Key-value pair with optional label |\n| Label | Dimension for separating settings (e.g., environments) |\n| Feature Flag | Special setting for feature management |\n| Secret Reference | Setting pointing to Key Vault secret |\n| Snapshot | Point-in-time immutable view of settings |\n\n## Configuration Setting Operations\n\n### Create Setting (Add)\n\nCreates only if setting doesn't exist:\n\n```java\nimport com.azure.data.appconfiguration.models.ConfigurationSetting;\n\nConfigurationSetting setting = configClient.addConfigurationSetting(\n    \"app\u002Fdatabase\u002Fconnection\", \n    \"Production\", \n    \"Server=prod.db.com;Database=myapp\"\n);\n```\n\n### Create or Update Setting (Set)\n\nCreates or overwrites:\n\n```java\nConfigurationSetting setting = configClient.setConfigurationSetting(\n    \"app\u002Fcache\u002Fenabled\", \n    \"Production\", \n    \"true\"\n);\n```\n\n### Get Setting\n\n```java\nConfigurationSetting setting = configClient.getConfigurationSetting(\n    \"app\u002Fdatabase\u002Fconnection\", \n    \"Production\"\n);\nSystem.out.println(\"Value: \" + setting.getValue());\nSystem.out.println(\"Content-Type: \" + setting.getContentType());\nSystem.out.println(\"Last Modified: \" + setting.getLastModified());\n```\n\n### Conditional Get (If Changed)\n\n```java\nimport com.azure.core.http.rest.Response;\nimport com.azure.core.util.Context;\n\nResponse\u003CConfigurationSetting> response = configClient.getConfigurationSettingWithResponse(\n    setting,      \u002F\u002F Setting with ETag\n    null,         \u002F\u002F Accept datetime\n    true,         \u002F\u002F ifChanged - only fetch if modified\n    Context.NONE\n);\n\nif (response.getStatusCode() == 304) {\n    System.out.println(\"Setting not modified\");\n} else {\n    ConfigurationSetting updated = response.getValue();\n}\n```\n\n### Update Setting\n\n```java\nConfigurationSetting updated = configClient.setConfigurationSetting(\n    \"app\u002Fcache\u002Fenabled\", \n    \"Production\", \n    \"false\"\n);\n```\n\n### Conditional Update (If Unchanged)\n\n```java\n\u002F\u002F Only update if ETag matches (no concurrent modifications)\nResponse\u003CConfigurationSetting> response = configClient.setConfigurationSettingWithResponse(\n    setting,     \u002F\u002F Setting with current ETag\n    true,        \u002F\u002F ifUnchanged\n    Context.NONE\n);\n```\n\n### Delete Setting\n\n```java\nConfigurationSetting deleted = configClient.deleteConfigurationSetting(\n    \"app\u002Fcache\u002Fenabled\", \n    \"Production\"\n);\n```\n\n### Conditional Delete\n\n```java\nResponse\u003CConfigurationSetting> response = configClient.deleteConfigurationSettingWithResponse(\n    setting,     \u002F\u002F Setting with ETag\n    true,        \u002F\u002F ifUnchanged\n    Context.NONE\n);\n```\n\n## List and Filter Settings\n\n### List by Key Pattern\n\n```java\nimport com.azure.data.appconfiguration.models.SettingSelector;\nimport com.azure.core.http.rest.PagedIterable;\n\nSettingSelector selector = new SettingSelector()\n    .setKeyFilter(\"app\u002F*\");\n\nPagedIterable\u003CConfigurationSetting> settings = configClient.listConfigurationSettings(selector);\nfor (ConfigurationSetting s : settings) {\n    System.out.println(s.getKey() + \" = \" + s.getValue());\n}\n```\n\n### List by Label\n\n```java\nSettingSelector selector = new SettingSelector()\n    .setKeyFilter(\"*\")\n    .setLabelFilter(\"Production\");\n\nPagedIterable\u003CConfigurationSetting> settings = configClient.listConfigurationSettings(selector);\n```\n\n### List by Multiple Keys\n\n```java\nSettingSelector selector = new SettingSelector()\n    .setKeyFilter(\"app\u002Fdatabase\u002F*,app\u002Fcache\u002F*\");\n\nPagedIterable\u003CConfigurationSetting> settings = configClient.listConfigurationSettings(selector);\n```\n\n### List Revisions\n\n```java\nSettingSelector selector = new SettingSelector()\n    .setKeyFilter(\"app\u002Fdatabase\u002Fconnection\");\n\nPagedIterable\u003CConfigurationSetting> revisions = configClient.listRevisions(selector);\nfor (ConfigurationSetting revision : revisions) {\n    System.out.println(\"Value: \" + revision.getValue() + \", Modified: \" + revision.getLastModified());\n}\n```\n\n## Feature Flags\n\n### Create Feature Flag\n\n```java\nimport com.azure.data.appconfiguration.models.FeatureFlagConfigurationSetting;\nimport com.azure.data.appconfiguration.models.FeatureFlagFilter;\nimport java.util.Arrays;\n\nFeatureFlagFilter percentageFilter = new FeatureFlagFilter(\"Microsoft.Percentage\")\n    .addParameter(\"Value\", 50);\n\nFeatureFlagConfigurationSetting featureFlag = new FeatureFlagConfigurationSetting(\"beta-feature\", true)\n    .setDescription(\"Beta feature rollout\")\n    .setClientFilters(Arrays.asList(percentageFilter));\n\nFeatureFlagConfigurationSetting created = (FeatureFlagConfigurationSetting)\n    configClient.addConfigurationSetting(featureFlag);\n```\n\n### Get Feature Flag\n\n```java\nFeatureFlagConfigurationSetting flag = (FeatureFlagConfigurationSetting)\n    configClient.getConfigurationSetting(featureFlag);\n\nSystem.out.println(\"Feature: \" + flag.getFeatureId());\nSystem.out.println(\"Enabled: \" + flag.isEnabled());\nSystem.out.println(\"Filters: \" + flag.getClientFilters());\n```\n\n### Update Feature Flag\n\n```java\nfeatureFlag.setEnabled(false);\nFeatureFlagConfigurationSetting updated = (FeatureFlagConfigurationSetting)\n    configClient.setConfigurationSetting(featureFlag);\n```\n\n## Secret References\n\n### Create Secret Reference\n\n```java\nimport com.azure.data.appconfiguration.models.SecretReferenceConfigurationSetting;\n\nSecretReferenceConfigurationSetting secretRef = new SecretReferenceConfigurationSetting(\n    \"app\u002Fsecrets\u002Fapi-key\",\n    \"https:\u002F\u002Fmyvault.vault.azure.net\u002Fsecrets\u002Fapi-key\"\n);\n\nSecretReferenceConfigurationSetting created = (SecretReferenceConfigurationSetting)\n    configClient.addConfigurationSetting(secretRef);\n```\n\n### Get Secret Reference\n\n```java\nSecretReferenceConfigurationSetting ref = (SecretReferenceConfigurationSetting)\n    configClient.getConfigurationSetting(secretRef);\n\nSystem.out.println(\"Secret URI: \" + ref.getSecretId());\n```\n\n## Read-Only Settings\n\n### Set Read-Only\n\n```java\nConfigurationSetting readOnly = configClient.setReadOnly(\n    \"app\u002Fcritical\u002Fsetting\", \n    \"Production\", \n    true\n);\n```\n\n### Clear Read-Only\n\n```java\nConfigurationSetting writable = configClient.setReadOnly(\n    \"app\u002Fcritical\u002Fsetting\", \n    \"Production\", \n    false\n);\n```\n\n## Snapshots\n\n### Create Snapshot\n\n```java\nimport com.azure.data.appconfiguration.models.ConfigurationSnapshot;\nimport com.azure.data.appconfiguration.models.ConfigurationSettingsFilter;\nimport com.azure.core.util.polling.SyncPoller;\nimport com.azure.core.util.polling.PollOperationDetails;\n\nList\u003CConfigurationSettingsFilter> filters = new ArrayList\u003C>();\nfilters.add(new ConfigurationSettingsFilter(\"app\u002F*\"));\n\nSyncPoller\u003CPollOperationDetails, ConfigurationSnapshot> poller = configClient.beginCreateSnapshot(\n    \"release-v1.0\",\n    new ConfigurationSnapshot(filters),\n    Context.NONE\n);\npoller.setPollInterval(Duration.ofSeconds(10));\npoller.waitForCompletion();\n\nConfigurationSnapshot snapshot = poller.getFinalResult();\nSystem.out.println(\"Snapshot: \" + snapshot.getName() + \", Status: \" + snapshot.getStatus());\n```\n\n### Get Snapshot\n\n```java\nConfigurationSnapshot snapshot = configClient.getSnapshot(\"release-v1.0\");\nSystem.out.println(\"Created: \" + snapshot.getCreatedAt());\nSystem.out.println(\"Items: \" + snapshot.getItemCount());\n```\n\n### List Settings in Snapshot\n\n```java\nPagedIterable\u003CConfigurationSetting> settings = \n    configClient.listConfigurationSettingsForSnapshot(\"release-v1.0\");\n\nfor (ConfigurationSetting setting : settings) {\n    System.out.println(setting.getKey() + \" = \" + setting.getValue());\n}\n```\n\n### Archive Snapshot\n\n```java\nConfigurationSnapshot archived = configClient.archiveSnapshot(\"release-v1.0\");\nSystem.out.println(\"Status: \" + archived.getStatus()); \u002F\u002F archived\n```\n\n### Recover Snapshot\n\n```java\nConfigurationSnapshot recovered = configClient.recoverSnapshot(\"release-v1.0\");\nSystem.out.println(\"Status: \" + recovered.getStatus()); \u002F\u002F ready\n```\n\n### List All Snapshots\n\n```java\nimport com.azure.data.appconfiguration.models.SnapshotSelector;\n\nSnapshotSelector selector = new SnapshotSelector().setNameFilter(\"release-*\");\nPagedIterable\u003CConfigurationSnapshot> snapshots = configClient.listSnapshots(selector);\n\nfor (ConfigurationSnapshot snap : snapshots) {\n    System.out.println(snap.getName() + \" - \" + snap.getStatus());\n}\n```\n\n## Labels\n\n### List Labels\n\n```java\nimport com.azure.data.appconfiguration.models.SettingLabelSelector;\n\nconfigClient.listLabels(new SettingLabelSelector().setNameFilter(\"*\"))\n    .forEach(label -> System.out.println(\"Label: \" + label.getName()));\n```\n\n## Async Operations\n\n```java\nConfigurationAsyncClient asyncClient = new ConfigurationClientBuilder()\n    .connectionString(connectionString)\n    .buildAsyncClient();\n\n\u002F\u002F Async list with reactive streams\nasyncClient.listConfigurationSettings(new SettingSelector().setLabelFilter(\"Production\"))\n    .subscribe(\n        setting -> System.out.println(setting.getKey() + \" = \" + setting.getValue()),\n        error -> System.err.println(\"Error: \" + error.getMessage()),\n        () -> System.out.println(\"Completed\")\n    );\n```\n\n## Error Handling\n\n```java\nimport com.azure.core.exception.HttpResponseException;\n\ntry {\n    configClient.getConfigurationSetting(\"nonexistent\", null);\n} catch (HttpResponseException e) {\n    if (e.getResponse().getStatusCode() == 404) {\n        System.err.println(\"Setting not found\");\n    } else {\n        System.err.println(\"Error: \" + e.getMessage());\n    }\n}\n```\n\n## Best Practices\n\n1. **Use labels** — Separate configurations by environment (Dev, Staging, Production)\n2. **Use snapshots** — Create immutable snapshots for releases\n3. **Feature flags** — Use for gradual rollouts and A\u002FB testing\n4. **Secret references** — Store sensitive values in Key Vault\n5. **Conditional requests** — Use ETags for optimistic concurrency\n6. **Read-only protection** — Lock critical production settings\n7. **Use Entra ID** — Preferred over connection strings\n8. **Async client** — Use for high-throughput scenarios\n\n## Reference Links\n\n| Resource | URL |\n|----------|-----|\n| Maven Package | https:\u002F\u002Fcentral.sonatype.com\u002Fartifact\u002Fcom.azure\u002Fazure-data-appconfiguration |\n| GitHub | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-java\u002Ftree\u002Fmain\u002Fsdk\u002Fappconfiguration\u002Fazure-data-appconfiguration |\n| API Documentation | https:\u002F\u002Faka.ms\u002Fjava-docs |\n| Product Docs | https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fazure-app-configuration |\n| Samples | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-java\u002Ftree\u002Fmain\u002Fsdk\u002Fappconfiguration\u002Fazure-data-appconfiguration\u002Fsrc\u002Fsamples |\n| Troubleshooting | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-java\u002Fblob\u002Fmain\u002Fsdk\u002Fappconfiguration\u002Fazure-data-appconfiguration\u002FTROUBLESHOOTING.md |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,191,1217,"2026-05-16 13:05:43",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"编程开发","coding","mdi-code-braces","代码生成、调试、审查，提升开发效率",2,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"DevOps","devops","mdi-cog-outline","CI\u002FCD、容器化、部署运维",3,162,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"7c0b35e9-93d1-464a-8edf-034c8e3c58cf","1.0.0","azure-appconfiguration-java.zip",3628,"uploads\u002Fskills\u002F5d3ef1d9-8a0c-4584-b351-78a797f513ad\u002Fazure-appconfiguration-java.zip","d6a59005eac35202d3296f38b6df70ee11aba96501f581066a3e5b059600d565","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":13292}]",{"code":44,"message":45,"data":46},200,"success",{"items":47,"stats":48,"page":51},[],{"averageRating":49,"totalRatings":49,"ratingCounts":50},0,[49,49,49,49,49],{"limit":52,"offset":49,"hasMore":53,"nextOffset":52,"ratedOnly":16},15,false]