1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141
|
<!--
~ Copyright (c) 2020 Goldman Sachs and others.
~ All rights reserved. This program and the accompanying materials
~ are made available under the terms of the Eclipse Public License v1.0
~ and Eclipse Distribution License v. 1.0 which accompany this distribution.
~ The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
~ and the Eclipse Distribution License is available at
~ http://www.eclipse.org/org/documents/edl-v10.php.
-->
[![][maven img]][maven]
[![][release img]][release]
[![][license-epl img]][license-epl]
[![][license-edl img]][license-edl]
[![][actions unit-tests img]][actions unit-tests]
[![][actions acceptance-tests img]][actions acceptance-tests]
[![][actions performance-tests img]][actions performance-tests]
[![][actions checkstyle img]][actions checkstyle]
[![][actions findbugs img]][actions findbugs]
[![][actions javadoc img]][actions javadoc]
<a href="https://www.eclipse.org/collections/"><img src="https://github.com/eclipse/eclipse-collections/blob/master/artwork/eclipse-collections-logo.png" height="50%" width="50%"></a>
#### [English](https://www.eclipse.org/collections/) | [中文](https://www.eclipse.org/collections/cn/index.html) | [Deutsch](https://www.eclipse.org/collections/de/index.html) | [Español](https://www.eclipse.org/collections/es/index.html) | [Ελληνικά](https://www.eclipse.org/collections/el/index.html) | [Français](https://www.eclipse.org/collections/fr/index.html) | [日本語](https://www.eclipse.org/collections/ja/index.html) | [Português-Brasil](https://www.eclipse.org/collections/pt-br/index.html) | [Русский](https://www.eclipse.org/collections/ru/index.html) | [हिंदी](https://www.eclipse.org/collections/hi/index.html)
Eclipse Collections is a comprehensive collections library for Java. The library enables productivity and performance by delivering an expressive and efficient set of APIs and types. The iteration protocol was inspired by the Smalltalk collection framework, and the collections are compatible with the Java Collection Framework types.
Eclipse Collections is compatible with Java 8+. Eclipse Collections is a part of the OpenJDK [Quality Outreach](https://wiki.openjdk.java.net/display/quality/Quality+Outreach) program, and it is validated for different versions of the OpenJDK.
## Why Eclipse Collections?
* Productivity
* [Rich][RichIterable], functional, and fluent APIs with great symmetry
* [`List`][ListIterable], [`Set`][SetIterable], [`Bag`][Bag], [`Stack`][StackIterable], [`Map`][MapIterable], [`Multimap`][Multimap], [`BiMap`][BiMap], [`Interval`][Interval] Types
* [Readable][RichIterable], [`Mutable`][MutableCollection], and [`Immutable`][ImmutableCollection] Types
* Mutable and Immutable Collection [Factories][Factories]
* [Adapters][Adapters] and [Utility][Utilities] classes for JCF Types
* Performance
* Memory Efficient Containers
* Optimized Eager, [`Lazy`][LazyIterable] and [`Parallel`][ParallelIterable] APIs
* [Primitive][PrimitiveIterable] Collections for all primitive types
## Learn Eclipse Collections
* [Some Quick Code Examples](./README_EXAMPLES.md)
* [Eclipse Collections Katas](https://github.com/eclipse/eclipse-collections-kata), a fun way to help you learn idiomatic Eclipse Collections usage.
* Start Here - [Pet Kata](http://eclipse.github.io/eclipse-collections-kata/pet-kata/#/)
* Continue Here - [Company Kata](http://eclipse.github.io/eclipse-collections-kata/company-kata/#/)
* [Eclipse Collections Reference Guide](https://github.com/eclipse/eclipse-collections/blob/master/docs/guide.md) and [Javadoc](https://www.eclipse.org/collections/javadoc/10.2.0/overview-summary.html)
* [Articles](https://github.com/eclipse/eclipse-collections/wiki/Articles) and [Blogs](https://medium.com/tag/eclipse-collections/latest)
## Acquiring Eclipse Collections
### Maven
```xml
<dependency>
<groupId>org.eclipse.collections</groupId>
<artifactId>eclipse-collections-api</artifactId>
<version>10.2.0</version>
</dependency>
<dependency>
<groupId>org.eclipse.collections</groupId>
<artifactId>eclipse-collections</artifactId>
<version>10.2.0</version>
</dependency>
```
### Gradle
```groovy
implementation 'org.eclipse.collections:eclipse-collections-api:10.2.0'
implementation 'org.eclipse.collections:eclipse-collections:10.2.0'
```
### OSGi Bundle
Eclipse software repository location: http://download.eclipse.org/collections/10.2.0/repository
## How to Contribute
We welcome contributions! We accept contributions via pull requests here in GitHub. Please see [How To Contribute](CONTRIBUTING.md) to get started.
## Additional information
* Project Website: http://www.eclipse.org/collections
* Eclipse PMI: https://projects.eclipse.org/projects/technology.collections
* StackOverflow: http://stackoverflow.com/questions/tagged/eclipse-collections
* Mailing lists: https://dev.eclipse.org/mailman/listinfo/collections-dev
* Forum: https://www.eclipse.org/forums/index.php?t=thread&frm_id=329
* Working with GitHub: https://github.com/eclipse/eclipse-collections/wiki/Working-with-GitHub
[actions acceptance-tests]:https://github.com/eclipse/eclipse-collections/actions?query=workflow%3A%22Acceptance+Tests%22
[actions acceptance-tests img]:https://github.com/eclipse/eclipse-collections/workflows/Acceptance%20Tests/badge.svg?branch=master
[actions unit-tests]:https://github.com/eclipse/eclipse-collections/actions?query=workflow%3A%22Unit+tests%22
[actions unit-tests img]:https://github.com/eclipse/eclipse-collections/workflows/Unit%20tests/badge.svg?branch=master
[actions performance-tests]:https://github.com/eclipse/eclipse-collections/actions?query=workflow%3A%22Performance+Tests%22
[actions performance-tests img]:https://github.com/eclipse/eclipse-collections/workflows/Performance%20Tests/badge.svg?branch=master
[actions checkstyle]:https://github.com/eclipse/eclipse-collections/actions?query=workflow%3A%22Checkstyle%22
[actions checkstyle img]:https://github.com/eclipse/eclipse-collections/workflows/Checkstyle/badge.svg?branch=master
[actions findbugs]:https://github.com/eclipse/eclipse-collections/actions?query=workflow%3A%22Findbugs%22
[actions findbugs img]:https://github.com/eclipse/eclipse-collections/workflows/Findbugs/badge.svg?branch=master
[actions javadoc]:https://github.com/eclipse/eclipse-collections/actions?query=workflow%3A%22JavaDoc%22
[actions javadoc img]:https://github.com/eclipse/eclipse-collections/workflows/JavaDoc/badge.svg?branch=master
[maven]:http://search.maven.org/#search|gav|1|g:"org.eclipse.collections"%20AND%20a:"eclipse-collections"
[maven img]:https://maven-badges.herokuapp.com/maven-central/org.eclipse.collections/eclipse-collections/badge.svg
[release]:https://github.com/eclipse/eclipse-collections/releases
[release img]:https://img.shields.io/github/release/eclipse/eclipse-collections.svg
[license-epl]:LICENSE-EPL-1.0.txt
[license-epl img]:https://img.shields.io/badge/License-EPL-blue.svg
[license-edl]:LICENSE-EDL-1.0.txt
[license-edl img]:https://img.shields.io/badge/License-EDL-blue.svg
[RichIterable]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/RichIterable.html
[ListIterable]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/list/ListIterable.html
[SetIterable]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/set/SetIterable.html
[Bag]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/bag/Bag.html
[StackIterable]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/stack/StackIterable.html
[MapIterable]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/map/MapIterable.html
[Multimap]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/multimap/Multimap.html
[BiMap]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/bimap/BiMap.html
[Interval]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/impl/list/Interval.html
[MutableCollection]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/collection/MutableCollection.html
[ImmutableCollection]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/collection/ImmutableCollection.html
[LazyIterable]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/LazyIterable.html
[ParallelIterable]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/ParallelIterable.html
[PrimitiveIterable]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/api/PrimitiveIterable.html
[Utilities]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/impl/utility/package-summary.html
[Adapters]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/impl/collection/mutable/AbstractCollectionAdapter.html
[Factories]: https://www.eclipse.org/collections/javadoc/10.2.0/org/eclipse/collections/impl/factory/package-summary.html
|