# ADR-0001 - Use Architectural Decision Records

## Status

- ACCEPTED on 2023-12-01

## Context

In a distributed team with many subteams, the best solution to communicate decisions is to use a format accessible by everyone in charge of development.

We use *Specification* and *Discovery* documents stored in Google Drive, but they present some downsides:

     * @throws IllegalAccessRuntimeException
     *             If this {@link Method} object enforces Java language access control and the underlying method is not accessible
     * @throws InvocationTargetRuntimeException
     *             If the underlying method throws an exception
     * @see Method#invoke(Object, Object[])
     */
    @SuppressWarnings("unchecked")

    // Not supported due to access checks on JDK 9+:
    // java.lang.reflect.InaccessibleObjectException: Unable to make member of class
    // sun.security.ssl.SSLSocketFactoryImpl accessible:  module java.base does not export
    // sun.security.ssl to unnamed module @xxx
    throw UnsupportedOperationException(
      "clientBuilder.sslSocketFactory(SSLSocketFactory) not supported on JDK 8 (>= 252) or JDK 9+",

 * repositories.</p>
 *
 * <p>There are several types of remote repositories:</p><ul>
 * <li><dfn>Central Repository</dfn>: The default remote repository used by Maven. It is a large, publicly accessible repository maintained by the Maven community at https://repo.maven.apache.org/maven2. Most common Java libraries and frameworks are hosted here.</li>

        }

        @Test
        @DisplayName("Should have FileSystemInformation constants accessible")
        void shouldHaveFileSystemInformationConstants() {
            // Verify constants are accessible through interface
            assertEquals(-1, FileSystemInformation.SMB_INFO_ALLOCATION);
            assertEquals(3, FileSystemInformation.FS_SIZE_INFO);

            assertTrue("Constructor should be protected", java.lang.reflect.Modifier.isProtected(constructor.getModifiers()));

            // Test that constructor is accessible when made accessible
            constructor.setAccessible(true);
            ThreadDumpUtil instance = constructor.newInstance();
            assertNotNull(instance);

```

### Windows

```sh
docker-compose.exe pull
docker-compose.exe up
```

or

```sh
docker stack deploy --compose-file docker-compose.yaml minio
```

Distributed instances are now accessible on the host using the Minio CLI on port 9000 and the Minio Web Console on port 9001. Proceed to access the Web browser at <http://127.0.0.1:9001/>. Here 4 MinIO server instances are reverse proxied through Nginx load balancing.

        String message = "Serialization test";
        LdapConfigurationException exception = new LdapConfigurationException(message);

        // Test that serialVersionUID is accessible (inherited from parent)
        assertNotNull(exception);

        // Create a new instance to verify it can be created multiple times
        LdapConfigurationException exception2 = new LdapConfigurationException(message);

        SmbComClose smbComClose = new SmbComClose(config, fid, lastWriteTime);

        // Then
        assertEquals(ServerMessageBlock.SMB_COM_CLOSE, smbComClose.getCommand());
        // Private fields are not directly accessible, but we can check their effect in other methods.
    }

    /**
     * Test method for {@link jcifs.internal.smb1.com.SmbComClose#writeParameterWordsWireFormat(byte[], int)}.
     */
    @Test

            assertTrue("Constructor should be private", java.lang.reflect.Modifier.isPrivate(constructor.getModifiers()));

            // Test that constructor is accessible when made accessible
            constructor.setAccessible(true);
            WebApiUtil instance = constructor.newInstance();
            assertNotNull(instance);