https://github.com/clickermonkey/curity
A Java library with data structures developed for various projects. Many of the structures have to do with concurrency and thread-safety.
https://github.com/clickermonkey/curity
Last synced: 11 months ago
JSON representation
A Java library with data structures developed for various projects. Many of the structures have to do with concurrency and thread-safety.
- Host: GitHub
- URL: https://github.com/clickermonkey/curity
- Owner: ClickerMonkey
- License: osl-3.0
- Created: 2013-04-30T17:53:05.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2013-11-15T20:45:50.000Z (about 12 years ago)
- Last Synced: 2025-01-27T10:23:16.542Z (about 1 year ago)
- Language: Java
- Homepage:
- Size: 273 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
curity
======
A Java library with data structures developed for various projects. Many of the structures have to do with concurrency.
**Classes**
- AtomicStack *- a thread-safe wait-free stack implementation.*
- BlockableQueue *- a queue implementation which can toggle between blocking and non-blocking.*
- ConcurrentSet *- a thread-safe set of objects.*
- Files *- file copying functionality.*
- Gate *- a lock that stops all waiting threads until one of the threads open the gate. An item is held behind the gate and all blocking threads receive that object upon opening.*
- Ref *- an interface that merely holds some value (get/set methods).*
- LockRef *- Ref implementation that is an efficient reentrant read-write lock. Readers don't block each other, but a write will.*
- NonNullRef *- Ref implementation that blocks until a non-null value is set*
- Notifier *- A dynamic proxy class used for notifying a list of listeners. Objects of the same type are added, when the proxy().METHOD is called, it calls METHOD on all objects added to the notifier.*
- Release *- A utility for unblocking blocking calls.*
- Signal *- Provides a way for several threads to send signals between each other.*
- Sleepable *-Any entity which blocks its thread for some period of time or until some event occurs and can be nicely awoken.*
- State *- A thread-safe state machine used for keeping track of the state of some object, waiting for a state to occur, and changing states.*
- EnumState *- Similar to State, but holds a single state (enum) opposed to multiple states*
**Documentation**
- [JavaDoc](http://gh.magnos.org/?r=http://clickermonkey.github.com/Curity/)
**Example**
```java
/** Snippet with the utilities that ARE NOT related to concurrency. See JavaDocs to
view snippets of concurrent classes. **/
// Copy one file/dir to another file/dir.
Files.copy(new File("src_dir"), new File("dst_dir"));
// A listener to the bar event
public interface Foo {
public void onBar();
}
// Create a notifier to invoke all Foos with one invocation.
Notifier notifier = Notifier.create(Foo.class);
notifier.add(new Foo());
notifier.add(new Foo());
// Invoke onBar to all Foo added to notifier
notifier.proxy().onBar();
```
**Builds**
- [curity-1.0.0.jar](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Curity/blob/master/build/curity-1.0.0.jar?raw=true)
- [curity-src-1.0.0.jar](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Curity/blob/master/build/curity-src-1.0.0.jar?raw=true) *- includes source code*
**Projects using curity:**
- [Taskaroo](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Taskaroo)
- [Statastic](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Statastic)
- [Daperz](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Daperz)
- [Surfice](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Surfice)
- [Zource](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Zource)
- [Falcon](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Falcon)
- [Buffero](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Buffero)
**Dependencies**
- [Testility](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Testility) *for unit tests*
**Testing Examples**
- [Testing/org/magnos/util](http://gh.magnos.org/?r=https://github.com/ClickerMonkey/Curity/tree/master/Testing/org/magnos/util)