abacus-common

A general programming library in Java. It's easy to learn and simple to use with concise and powerful APIs.

Features:

• Most daily used APIs: CommonUtil, N, Strings, Numbers, Array, Iterables, Iterators, Maps, Dates, IOUtil, Files, Index, Indexed, Keyed, If, Try, Synchronized, Retry, Multiset, Multimap, ListMultimap, SetMultimap, DataSet, Sheet, BiMap, ImmutableList, ImmutableSet, ImmutableMap, Result, Holder, Pair, Triple, Tuple, Range, Duration, Fraction, Splitter, Joiner, Builder, Difference, Comparators, Hashing, Clazz, Hex, DigestUtil, RegExUtil, URLEncodedUtil, AsyncExecutor, ContinuableFuture, Futures, JSONUtil, Profiler...

• Primitive Mutable: MutableBoolean, MutableChar, MutableByte, MutableShort, MutableInt, MutableLong, MutableFloat and MutableDouble.

• Primitive List: PrimitiveList, BooleanList, CharList, ByteList, ShortList, IntList, LongList, FloatList and DoubleList.

• Primitive/Immutable Iterator: ObjIterator, BooleanIterator, CharIterator, ByteIterator, ShortIterator, IntIterator, LongIterator, FloatIterator, DoubleIterator, BiIterator, TriIterator and LineIterator.

• Optional: OptionalBoolean, OptionalChar, OptionalByte, OptionalShort, OptionalInt, OptionalLong, OptionalFloat, OptionalDouble, Optional and Nullable

• Streams, both sequential and parallel, are supported with more functions: Seq, BaseStream, Stream, CharStream, ByteStream, ShortStream, IntStream, LongStream, FloatStream, DoubleStream, EntryStream, Fn, more Collectors and Throwables.

• JSON/XML Data Binding: Parser, JSONParser, XMLParser, KryoParser, ParserFactory...

• Http: HttpClient, HttpRequest, OkHttpRequest, and More ...

• Pool: Pool, ObjectPool, KeyedObjectPool, PoolFactory...

• More: CodeGenerationUtil, JsonMappers, XmlMappers, Charsets, Ascii, CalendarField, NamingPolicy, Properties, PropertiesUtil, Configuration, XmlUtil, Wrapper, ClassUtil, CSVUtil, EscapeUtil, FilenameUtil, AddrUtil, WSSecurityUtil, EmailUtil, IEEE754rUtil, Timed, IndexedKeyed, Median, Stopwatch, RateLimiter, TypeReference, WebUtil, Files, Traverser(copied from Apache commons, Google Guava...under Apache License v2) ...

Download/Installation & Changes:

• Maven

<dependency>
	<groupId>com.landawn</groupId>
	<artifactId>abacus-common</artifactId>
	<version>5.8.2</version> 
<dependency>

• Gradle:

// JDK 17 or above:
compile 'com.landawn:abacus-common:5.8.2'

Functional Programming:

(It's very important to learn Lambdas and Stream APIs in Java 8 to get the best user experiences with the APIs provided in abacus-common)

What's New in Java 8

An introduction to the java.util.stream library

When to use parallel streams

Top Java 8 stream questions on stackoverflow

Kotlin vs Java 8 on Collection

User Guide:

Please refer to Wiki

Also See: abacus-jdbc, abacus-query, abacus-extra, abacus-cache and abacus-android

Recommended Java programming libraries/frameworks:

lombok, Guava, protobuf, Kyro, snappy-java, lz4-java, Caffeine, Ehcache, Chronicle-Map, echarts, Chartjs, Highcharts, Apache POI, easyexcel, opencsv, mapstruct, fastutil, hppc, re2j ... awesome-java

Recommended Java programming tools:

Spotbugs, JaCoCo...

A Few Principles About Design and Implementation in This Library:

• In general, empty String, Collection, Map, etc., are returned instead of null. However, null may be returned in certain methods, such as Strings.firstNonEmpty() or Strings.emptyToNull(). Methods that may return null are typically annotated with @MayReturnNull.

• Methods are designed to support broad and general use cases. null parameters are usually allowed, as long as they do not violate the contract of the method. For example: Numbers.createNumber(...) or N.filter(...). It is up to the user to handle null values appropriately if they are invalid in a given context.

• Due to the large number of methods in this library, consistently handling exceptions such as IllegalArgumentException, NullPointerException, IndexOutOfBoundsException, and similar across the entire codebase is challenging. Therefore, these exceptions should not be treated differently. The following approach is not recommended:

		try {
		    call some methods which may throw IllegalArgumentException or NullPointerException in this library.
		} catch (IllegalArgumentException e) {
		    // do something.
		} catch (NullPointerException e) {
		    // do something else.
		}

• More refer to: How To Design A Good API and Why it Matters

If Proposals is slow with Big class: N, Strings, Stream, Open the class file and explore the methods in outline once. Then test again.

                           ...beyond imagination...