1 /*
2  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License").
5  * You may not use this file except in compliance with the License.
6  * A copy of the License is located at
7  *
8  *  http://aws.amazon.com/apache2.0
9  *
10  * or in the "license" file accompanying this file. This file is distributed
11  * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
12  * express or implied. See the License for the specific language governing
13  * permissions and limitations under the License.
14  */
15
16 package software.amazon.awssdk.regions.providers;
17
18 import software.amazon.awssdk.annotations.SdkProtectedApi;
19 import software.amazon.awssdk.core.SdkSystemSetting;
20 import software.amazon.awssdk.core.exception.SdkClientException;
21 import software.amazon.awssdk.regions.Region;
22
23 /**
24  * Loads region information from the 'aws.region' system property or the 'AWS_REGION' environment variable. If both are specified,
25  * the system property will be used.
26  */
27 @SdkProtectedApi
28 public final class SystemSettingsRegionProvider implements AwsRegionProvider {
29     @Override
30     public Region getRegion() throws SdkClientException {
31         return SdkSystemSetting.AWS_REGION.getStringValue()
32                                           .map(Region::of)
33                                           .orElseThrow(this::exception);
34     }
35
36     private SdkClientException exception() {
37         return SdkClientException.builder().message(String.format("Unable to load region from system settings. Region" +
38                                                     " must be specified either via environment variable (%s) or " +
39                                                     " system property (%s).",
40                                                     SdkSystemSetting.AWS_REGION.environmentVariable(),
41                                                     SdkSystemSetting.AWS_REGION.property())).build();
42     }
43 }
44