disposables

WebJar for disposables

License	Apache-2.0
GroupId	org.webjars.npm
ArtifactId	disposables
Last Version	1.0.2
Release Date	Apr 30, 2021
Type	jar
Description	disposables WebJar for disposables
Project URL	https://www.webjars.org
Source Code Management	https://github.com/gaearon/disposables

Download disposables

Filename	Size
disposables-1.0.2.pom
disposables-1.0.2.jar	64 KB
disposables-1.0.2-sources.jar	22 bytes
disposables-1.0.2-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/disposables/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>disposables</artifactId>
    <version>1.0.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/disposables/
implementation 'org.webjars.npm:disposables:1.0.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/disposables/
implementation ("org.webjars.npm:disposables:1.0.2")

Apache Buildr

'org.webjars.npm:disposables:jar:1.0.2'

Apache Ivy

<dependency org="org.webjars.npm" name="disposables" rev="1.0.2">
  <artifact name="disposables" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='disposables', version='1.0.2')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "disposables" % "1.0.2"

Leiningen

[org.webjars.npm/disposables "1.0.2"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

NOT ACTIVELY MAINTAINED

This project works fine but is not actively maintained.
For the new code, you might want to try the new official rx.disposables package instead.

disposables

Disposables let you safely compose resource disposal semantics.
Think DOM nodes, event handlers, socket connections.

This implementation of disposables is extracted from RxJS.
I took the liberty to tweak the code style to my liking and provide this as a standalone package.

This tiny package includes several disposables:

• Disposable ensures its dispose action runs only once;
• CompositeDisposable ensures a group of disposables are disposed together;
• SerialDisposable switches underlying disposables on the fly and disposes them.

The API is mostly the same as RxJS except stricter in a few places.
It does not strive for 100% API compatibility with RxJS, but generally behavior is the same.

It's best if you consult the source and tests, as classes are small and few.

Usage

import { Disposable, CompositeDisposable, SerialDisposable } from 'disposables';

// or you can import just the ones you need to keep it even tinier
// import SerialDisposable from 'disposables/modules/SerialDisposable';

function attachHandlers(node) {
	let someHandler = ...;
	node.addEventHandler(someHandler);

	// use Disposable to guarantee single execution
	return new Disposable(() => {
	  node.removeEventHandler(someHandler);
	});
}

// CompositeDisposable lets you compose several disposables...
let nodes = ...;
let compositeDisp = new CompositeDisposable(nodes.map(attachHandlers));

// and more later...
let moreNodes = ...
moreNodes.map(attachHandlers).forEach(d => compositeDisp.add(d));

// and dispose them at once!
function goodbye() {
	compositeDisp.dispose();
}

// ... or replace with a bunch of new ones ...
let serialDisp = new SerialDisposable();
serialDisp.setDisposable(compositeDisp);

function replaceNodes(newNodes) {
	let nextCompositeDisp = new CompositeDisposable(newNodes.map(attachHandlers));

	// release all the previous disposables:
	serialDisp.setDisposable(nextCompositeDisp);
}

// with a guarantee of each dispose() called only once.

License

Like the original RxJS code, it is licensed under Apache 2.0.

Versions

Version
1.0.2 Apr 30, 2021
1.0.1 May 25, 2016