# ADR-0006 - Use of Provider APIs in Gradle

## Status

- ACCEPTED on 2024-06-21

## Context

        FessSecurityResourceProvider provider1 = new FessSecurityResourceProvider(inver1, oneWay1);
        FessSecurityResourceProvider provider2 = new FessSecurityResourceProvider(inver2, oneWay2);

        assertNotSame(provider1, provider2);
        assertEquals(inver1, provider1.providePrimaryInvertibleCryptographer());
        assertEquals(inver2, provider2.providePrimaryInvertibleCryptographer());

/**
 * Returns a new provider that takes its value from at most one
 * of the given providers. If no input provider is present, the output
 * provider will not be present. If more than one input provider
 * has a value specified, the resulting provider will throw an
 * exception when queried.
 */
fun <T: Any> atMostOneOf(vararg providers: Provider<T>): Provider<T> {
    return providers.map { provider ->

        // When
        DfFinalTimeZoneProvider provider = curtainBeforeHook.createFinalTimeZoneProvider();

        // Then
        TimeZone first = provider.provide();
        TimeZone second = provider.provide();
        assertSame(first, second, "Provider should return the same TimeZone instance");
    }

    @Test

        // Verify it's the same instance for all provider instances
        FessUserTimeZoneProcessProvider provider1 = new FessUserTimeZoneProcessProvider();
        FessUserTimeZoneProcessProvider provider2 = new FessUserTimeZoneProcessProvider();

        TimeZone tz1 = provider1.getRequestedTimeZone(requestManager);
        TimeZone tz2 = provider2.getRequestedTimeZone(requestManager);

        assertSame(tz1, tz2);

        // test that it consistently returns null for any input
        assertNull(invokeMethod(provider, "findOnMainSchema", "TestClassification"));
        assertNull(invokeMethod(provider, "findOnMainSchema", ""));
        assertNull(invokeMethod(provider, "findOnMainSchema", "Some.Classification"));
        assertNull(invokeMethod(provider, "findOnMainSchema", "Project.TestClassification"));
    }

    @Test

        assertNotNull(provider2);
        assertNotNull(provider3);

        // Each should be a different instance
        assertNotSame(provider1, provider2);
        assertNotSame(provider2, provider3);
        assertNotSame(provider1, provider3);
    }

    // Test with special characters in time adjustment string
    @Test
    public void test_specialCharactersInTimeAdjustment() {

        }
    }

    // Test provider as CookieResourceProvider interface
    @Test
    public void test_asInterface() {
        CookieResourceProvider provider = cookieResourceProvider;
        assertNotNull(provider);

        String path = provider.provideDefaultPath();
        assertEquals("/test/path", path);

        Integer expire = provider.provideDefaultExpire();

            providedBy.forEachIndexed { idx, provider ->
                if (provider != selected) {
                    components.declareSyntheticCapability(provider, idx.toString())
                }
            }
            components.declareCapabilityPreference(selected)
        }
    }

    private
    fun ComponentMetadataHandler.declareSyntheticCapability(provider: String, version: String) {

import org.gradle.api.file.DirectoryProperty;
import org.gradle.api.file.DuplicatesStrategy;
import org.gradle.api.file.ProjectLayout;
import org.gradle.api.file.RelativePath;
import org.gradle.api.provider.Provider;
import org.gradle.api.tasks.PathSensitivity;
import org.gradle.api.tasks.SourceSetContainer;
import org.gradle.api.tasks.Sync;
import org.gradle.api.tasks.TaskContainer;
import org.gradle.api.tasks.TaskInputs;