JarCasting
JarCasting JarCasting

cos-spring

Spring configuration for the official COS SDK for Java

License

License
GroupId

GroupId

com.ibm.cos
ArtifactId

ArtifactId

cos-spring
Last Version

Last Version

1.0.3
Release Date

Release Date
Type

Type

pom
Description

Description

cos-spring
Spring configuration for the official COS SDK for Java
Project URL

Project URL

https://github.com/ibm/cos-spring
Source Code Management

Source Code Management

https://github.com/IBM/cos-spring/tree/master

Download cos-spring

Filename Size
cos-spring-1.0.3.pom 8 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.ibm.cos/cos-spring/ -->
<dependency>
    <groupId>com.ibm.cos</groupId>
    <artifactId>cos-spring</artifactId>
    <version>1.0.3</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/com.ibm.cos/cos-spring/
implementation 'com.ibm.cos:cos-spring:1.0.3'
// https://jarcasting.com/artifacts/com.ibm.cos/cos-spring/
implementation ("com.ibm.cos:cos-spring:1.0.3")
'com.ibm.cos:cos-spring:pom:1.0.3'
<dependency org="com.ibm.cos" name="cos-spring" rev="1.0.3">
  <artifact name="cos-spring" type="pom" />
</dependency>
@Grapes(
@Grab(group='com.ibm.cos', module='cos-spring', version='1.0.3')
)
libraryDependencies += "com.ibm.cos" % "cos-spring" % "1.0.3"
[com.ibm.cos/cos-spring "1.0.3"]

Dependencies

compile (1)

Group / Artifact Type Version
com.ibm.cos : ibm-cos-java-sdk jar 2.5.2

test (1)

Group / Artifact Type Version
junit : junit jar 4.12

Project Modules

  • cos-spring-boot-starter
  • cos-spring-boot-starter-test
  • cos-spring-framework
  • cos-spring-framework-test

IBM Cloud Object Storage Spring Library

The is a library to provide Spring developers easy configuration of the IBM COS SDK for Java.

The library is split into two parts:

Installation and Usage

Spring Boot Applications

Gradle:

dependencies {
    compile group: 'com.ibm.cos', name: 'cos-spring-boot-starter', version: '1.0.0'
}

Maven:

<dependency>
  <groupId>com.ibm.cos</groupId>
  <artifactId>cos-spring-boot-starter</artifactId>
  <version>1.0.0</version>
</dependency>

Spring Framework Applications

Gradle:

dependencies {
    compile group: 'com.ibm.cos', name: 'cos-spring-framework', version: '1.0.0'
}

Maven:

<dependency>
  <groupId>com.ibm.cos</groupId>
  <artifactId>cos-spring-framework</artifactId>
  <version>1.0.0</version>
</dependency>

Getting Started

This section contains simple examples of connecting to COS using the two libraries.

Spring Boot Applications

To enable auto-configuration you must provide the following properties to define the connection to your COS instance:

  • cos.endpoint
  • cos.location

Additionally, you must determine which type of credentials you wish to use; either IAM API Key or HMAC credentials. If using an IAM API Key credential, an optional Service Instance ID may be provided to enable support for Bucket listing and Bucket creation operations. If using HMAC credentials, Access Key and Secret Key properties are both required.

For example using IAM credentials with an optional Service Instance ID in an application.properties file:

cos.endpoint=https://s3-api.us-geo.objectstorage.softlayer.net
cos.location=us
cos.api-key=myApiKey
cos.service-instance-id=myServiceInstanceId

Another example using HMAC credentials:

cos.endpoint=https://s3-api.us-geo.objectstorage.softlayer.net
cos.location=us
cos.access-key=myAccessKey
cos.secret-key=mySecretKey

Spring Boot will create a com.ibm.cloud.objectstorage.services.s3.AmazonS3 bean that can be used to interact with your COS instance:

@Autowired
private AmazonS3 client;

public boolean isBucketAvailable(String bucket) {
    return client.doesBucketExist(bucket);
}

To provide custom client options you can override the com.ibm.cloud.objectstorage.services.s3.AmazonS3ClientBuilder bean and provide your own properties:

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    @Value("${cos.endpoint}")
    private URL endpoint;

    @Value("${cos.location}")
    private String location;

    @Value("${cos.api-key}")
    private String apiKey

    @Bean
    public AmazonS3ClientBuilder builder() {
        return AmazonS3ClientBuilder.standard()
        .withEndpointConfiguration(
            new EndpointConfiguration(endpoint.toString(), location))
        .withCredentials(new AWSStaticCredentialsProvider(new BasicIBMOAuthCredentials(apiKey, null);))
        .withPathStyleAccessEnabled(true);
    }
}

application.properties:

cos.endpoint=https://s3-api.us-geo.objectstorage.softlayer.net
cos.location=us
cos.api-key=myApiKey

Spring Framework Applications

See Spring Boot section for required and optional properties.

To enable the creation of the com.ibm.cloud.objectstorage.services.s3.AmazonS3 bean you must add an com.ibm.cos.spring.framework.EnableCOS annotation to your application configuration:

@Configuration
@EnableWebMvc
@EnableCOS
@ComponentScan
public class SpringConfig {}
@Autowired
private AmazonS3 client;

public boolean isBucketAvailable(String bucket) {
    return client.doesBucketExist(bucket);
}

Related documentation

License

Copyright © 2018 IBM Corp. All rights reserved.

Licensed under the apache license, version 2.0 (the "license"); you may not use this file except in compliance with the license. you may obtain a copy of the license at

http://www.apache.org/licenses/LICENSE-2.0.html

Unless required by applicable law or agreed to in writing, software distributed under the license is distributed on an "as is" basis, without warranties or conditions of any kind, either express or implied. See the license for the specific language governing permissions and limitations under the license.

Getting help

Feel free to use GitHub issues for tracking bugs and feature requests, but for help please use one of the following resources:

com.ibm.cos

International Business Machines

Versions

Version
1.0.3
1.0.2
1.0.1
1.0.0