JarCasting
JarCasting JarCasting

urn

Object storage library

License

License
GroupId

GroupId

com.sangupta
ArtifactId

ArtifactId

urn
Last Version

Last Version

0.1.0
Release Date

Release Date
Type

Type

jar
Description

Description

urn
Object storage library
Project URL

Project URL

http://sangupta.com/projects/urn
Source Code Management

Source Code Management

https://github.com/sangupta/urn

Download urn

Filename Size
urn-0.1.0.pom
urn-0.1.0.jar 9 KB
urn-0.1.0-sources.jar 8 KB
urn-0.1.0-javadoc.jar 67 KB
Browse

How to add to project

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

Dependencies

compile (1)

Group / Artifact Type Version
com.sangupta : jerry-core jar 2.4.0

provided (2)

Group / Artifact Type Version
org.springframework.data : spring-data-mongodb jar 1.8.2.RELEASE
org.springframework.data : spring-data-redis jar 1.6.2.RELEASE

test (4)

Group / Artifact Type Version
junit : junit jar 4.12
com.github.fakemongo : fongo jar 1.6.5
com.sangupta : dryrun jar 0.1.0
com.fiftyonred : mock-jedis jar 0.4.0

Project Modules

There are no modules declared in this project.

urn

Build Status Coverage Status Maven Version

urn is a Java library that helps integrate with different object stores via a simple API, allowing you to change the provider at runtime without changing the code.

Currently available object store providers:

  • In-memory
  • Flat-file on disk
  • Redis
  • MongoDB - collection based
  • MongoDB - GridFS based

Ones in the pipeline:

  • Amazon S3
  • SeaWeedFS
  • LevelDB
  • RocksDB
  • SQlite

Features

  • Ability for time-based eviction of each individual asset (depends on provider)
  • Metadata storage with object like MIME type
  • Custom name that can be set, different from the unique key

Feature Roadmap

  • A simple server that can serve the raw stream using the key

Usage

Using urn is pretty straight-forward:

UrnStorageService service = new RedisUrnStorageServiceImpl();

String objectKey = "myObject-123";

// save a new object
service.saveObject(objectKey, getRandomBytes());

// check if the object is saved or not
service.existsObject(objectKey); // returns true

// retrieve data
service.getObjectBytes(objectKey); // returns the byte[]

// delete object
service.remove(objectKey);
service.existsObject(objectKey); // returns false

Versioning

For transparency and insight into our release cycle, and for striving to maintain backward compatibility, urn will be maintained under the Semantic Versioning guidelines as much as possible.

Releases will be numbered with the follow format:

<major>.<minor>.<patch>

And constructed with the following guidelines:

  • Breaking backward compatibility bumps the major
  • New additions without breaking backward compatibility bumps the minor
  • Bug fixes and misc changes bump the patch

For more information on SemVer, please visit http://semver.org/.

License

urn - Object storage library
Copyright (c) 2016, Sandeep Gupta

http://sangupta.com/projects/urn

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

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.

Versions

Version
0.1.0