*       have, of returning a new, independent iterator
 * </ul>
 *
 * <p>Because of this situation, any public method accepting an iterable should invoke the {@code
 * iterator} method only once, and should be tested using this class. Exceptions to this rule should
 * be clearly documented.
 *
 * <p>Note that although your APIs should be liberal in what they accept, your methods which

 * <p>
 * Beans injected into Mojo parameters are prepared by <a href="https://www.eclipse.org/sisu/">Sisu</a> JSR330-based
 * container: this annotation is only effective on fields of the Mojo class itself, nested bean injection
 * requires Sisu or JSR330 annotations.
 *
 * @since 4.0.0
 */
@Experimental
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.METHOD})
@Inherited

Таким чином його схема з'явиться в інтерфейсі користувача документації API:

<img src="/img/tutorial/dataclasses/image01.png">

## Dataclasses у вкладених структурах даних { #dataclasses-in-nested-data-structures }

Можна поєднувати `dataclasses` з іншими анотаціями типів, щоб створювати вкладені структури даних.

        assertEquals("", item.getPath());
    }

    public void test_deeplyNestedPath() {
        final String deepPath = "/level1/level2/level3/level4/level5/";
        final StorageItem item = new StorageItem("nested.txt", deepPath, false, 256L, null, "bmVzdGVkLnR4dA==");

        assertEquals(deepPath, item.getPath());
    }

    public void test_specialCharactersInName() {

    assertEquals(2, copy.size());
    assertThat(copy.iterator().next().member).isSameInstanceAs(copy);
  }

  /*
   * The behavior of toString() and iteration is tested by LinkedHashMultiset,
   * which shares a lot of code with HashMultiset and has deterministic
   * iteration order.
   */

    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <!--
    Some tests need reflective access to the internals of these packages. It is only the
    tests themselves and not the code being tested that needs that access, though there's no
    obvious way to ensure that.

    We could consider arranging things so that only the tests we know need this would get

        // getMessage() may return null when constructed with null
        // This is expected behavior for exceptions with null cause
    }

    @Test
    public void test_nestedCause() {
        // Test with nested exceptions
        RuntimeException rootCause = new RuntimeException("Root cause");
        ParseException parseException = new ParseException("Parse error");
        parseException.initCause(rootCause);

        assertEquals(0, SessionSetupHandler.class.getDeclaredFields().length, "No fields expected");
        assertEquals(0, SessionSetupHandler.class.getDeclaredClasses().length, "No nested types expected");
    }

    @ParameterizedTest(name = "Implementation is instance: {0}")
    @MethodSource("implementations")
    @DisplayName("Happy path: can create implementations and use type checks")

import static org.mockito.Mockito.never;
import static org.mockito.Mockito.times;
import static org.mockito.Mockito.verify;

import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Nested;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;

            // confirm element doesn't contain nested XML
            if (parser.next() != XmlPullParser.START_TAG) {
                return convertText(text, clazz == rawType ? toType : TypeLiteral.get(clazz));
            }
        }

        if (String.class == clazz) {
            // mimic plexus: discard any strings containing nested XML
            while (parser.getEventType() == XmlPullParser.START_TAG) {