rspec/rules/S4265/java/rule.adoc

Both ``++FixedSizeList++`` from the Commons library, and the list returned from ``++Arrays.asList++`` offer ``++add++`` and ``++remove++`` methods (as required by the ``++List++`` interface they implement), but neither truly supports their use. Both list types have fixed lengths and will throw errors if an ``++add++`` or ``++remove++`` method, or any of their variations, is called.


This rule raises an issue when one of the following methods is invoked on a ``++FixedSizeList++`` instance:

* ``++add++``
* ``++addAll++``
* ``++clear++``
* ``++remove++``
* ``++removeAll++``


== Noncompliant Code Example

[source,java]
----
List<String> strings = Arrays.asList("Hello");
strings.add("world");  // Noncompliant
----


== Compliant Solution

[source,java]
----
List<String> strings = Arrays.asList("Hello", "world");
----


ifdef::env-github,rspecator-view[]

'''
== Implementation Specification
(visible only on this page)

include::message.adoc[]

include::highlighting.adoc[]

'''
== Comments And Links
(visible only on this page)

include::comments-and-links.adoc[]
endif::env-github,rspecator-view[]