Copyright (c) Microsoft Corporation. All rights reserved.
Licensed under the MIT License. See License.txt in the project root for
license information.
/**
 * Copyright (c) Microsoft Corporation. All rights reserved.
 * Licensed under the MIT License. See License.txt in the project root for
 * license information.
 */
package com.microsoft.azure.management.sql;

import com.microsoft.azure.management.apigeneration.Beta;
import com.microsoft.azure.management.apigeneration.Fluent;
import com.microsoft.azure.management.apigeneration.Method;
import rx.Completable;
import rx.Observable;

import java.util.List;

Base class for Azure SQL Server child resource operations.
Type parameters:
<T> – the FluentT interface of the SQL server child resource/**
 * Base class for Azure SQL Server child resource operations.
 *
 * @param <T> the FluentT interface of the SQL server child resource
 */
@Fluent
@Beta(Beta.SinceVersion.V1_7_0)
public interface SqlChildrenOperations<T> {

    
Gets the information about a child resource from Azure SQL server, identifying it by its name and its resource group.
Params:
resourceGroupName – the name of resource group
sqlServerName – the name of SQL server parent resource
name – the name of the child resource
Returns:
an immutable representation of the resource/**
     * Gets the information about a child resource from Azure SQL server, identifying it by its name and its resource group.
     *
     * @param resourceGroupName the name of resource group
     * @param sqlServerName the name of SQL server parent resource
     * @param name the name of the child resource
     * @return an immutable representation of the resource
     */
    T getBySqlServer(String resourceGroupName, String sqlServerName, String name);

    
Asynchronously gets the information about a child resource from Azure SQL server, identifying it by its name and its resource group.
Params:
resourceGroupName – the name of resource group
sqlServerName – the name of SQL server parent resource
name – the name of the child resource
Returns:
a representation of the deferred computation of this call returning the found resource/**
     * Asynchronously gets the information about a child resource from Azure SQL server, identifying it by its name and its resource group.
     *
     * @param resourceGroupName the name of resource group
     * @param sqlServerName the name of SQL server parent resource
     * @param name the name of the child resource
     * @return a representation of the deferred computation of this call returning the found resource
     */
    Observable<T> getBySqlServerAsync(String resourceGroupName, String sqlServerName, String name);

    
Gets the information about a child resource from Azure SQL server, identifying it by its name and its resource group.
Params:
sqlServer – the SQL server parent resource
name – the name of the child resource
Returns:
an immutable representation of the resource/**
     * Gets the information about a child resource from Azure SQL server, identifying it by its name and its resource group.
     *
     * @param sqlServer the SQL server parent resource
     * @param name the name of the child resource
     * @return an immutable representation of the resource
     */
    T getBySqlServer(SqlServer sqlServer, String name);

    
Asynchronously gets the information about a child resource from Azure SQL server, identifying it by its name and its resource group.
Params:
sqlServer – the SQL server parent resource
name – the name of the child resource
Returns:
a representation of the deferred computation of this call returning the found resource/**
     * Asynchronously gets the information about a child resource from Azure SQL server, identifying it by its name and its resource group.
     *
     * @param sqlServer the SQL server parent resource
     * @param name the name of the child resource
     * @return a representation of the deferred computation of this call returning the found resource
     */
    @Beta(Beta.SinceVersion.V1_8_0)
    Observable<T> getBySqlServerAsync(SqlServer sqlServer, String name);

    
Gets the information about a child resource from Azure SQL server using the resource ID.
Params:
id – the ID of the resource.
Returns:
an immutable representation of the resource/**
     * Gets the information about a child resource from Azure SQL server using the resource ID.
     *
     * @param id the ID of the resource.
     * @return an immutable representation of the resource
     */
    T getById(String id);

    
Asynchronously gets the information about a child resource from Azure SQL server using the resource ID.
Params:
id – the ID of the resource.
Returns:
a representation of the deferred computation of this call/**
     * Asynchronously gets the information about a child resource from Azure SQL server using the resource ID.
     *
     * @param id the ID of the resource.
     * @return a representation of the deferred computation of this call
     */
    Observable<T> getByIdAsync(String id);

    
Deletes a child resource from Azure SQL server, identifying it by its name and its resource group.
Params:
resourceGroupName – the name of resource group
sqlServerName – the name of SQL server parent resource
name – the name of the child resource/**
     * Deletes a child resource from Azure SQL server, identifying it by its name and its resource group.
     *
     * @param resourceGroupName the name of resource group
     * @param sqlServerName the name of SQL server parent resource
     * @param name the name of the child resource
     */
    void deleteBySqlServer(String resourceGroupName, String sqlServerName, String name);

    
Asynchronously delete a child resource from Azure SQL server, identifying it by its name and its resource group.
Params:
resourceGroupName – the name of resource group
sqlServerName – the name of SQL server parent resource
name – the name of the child resource
Returns:
a representation of the deferred computation of this call/**
     * Asynchronously delete a child resource from Azure SQL server, identifying it by its name and its resource group.
     *
     * @param resourceGroupName the name of resource group
     * @param sqlServerName the name of SQL server parent resource
     * @param name the name of the child resource
     * @return a representation of the deferred computation of this call
     */
    Completable deleteBySqlServerAsync(String resourceGroupName, String sqlServerName, String name);

    
Deletes a child resource from Azure SQL server, identifying it by its resource ID.
Params:
id – the resource ID of the resource to delete/**
     * Deletes a child resource from Azure SQL server, identifying it by its resource ID.
     *
     * @param id the resource ID of the resource to delete
     */
    void deleteById(String id);

    
Asynchronously delete a child resource from Azure SQL server, identifying it by its resource ID.
Params:
id – the resource ID of the resource to delete
Returns:
a representation of the deferred computation of this call/**
     * Asynchronously delete a child resource from Azure SQL server, identifying it by its resource ID.
     *
     * @param id the resource ID of the resource to delete
     * @return a representation of the deferred computation of this call
     */
    Completable deleteByIdAsync(String id);

    
Lists Azure SQL child resources of the specified Azure SQL server in the specified resource group.
Params:
resourceGroupName – the name of the resource group to list the resources from
sqlServerName – the name of parent Azure SQL server.
Returns:
the list of resources/**
     * Lists Azure SQL child resources of the specified Azure SQL server in the specified resource group.
     *
     * @param resourceGroupName the name of the resource group to list the resources from
     * @param sqlServerName the name of parent Azure SQL server.
     * @return the list of resources
     */
    List<T> listBySqlServer(String resourceGroupName, String sqlServerName);

    
Asynchronously lists Azure SQL child resources of the specified Azure SQL server in the specified resource group.
Params:
resourceGroupName – the name of the resource group to list the resources from
sqlServerName – the name of parent Azure SQL server.
Returns:
a representation of the deferred computation of this call/**
     * Asynchronously lists Azure SQL child resources of the specified Azure SQL server in the specified resource group.
     *
     * @param resourceGroupName the name of the resource group to list the resources from
     * @param sqlServerName the name of parent Azure SQL server.
     * @return a representation of the deferred computation of this call
     */
    Observable<T> listBySqlServerAsync(String resourceGroupName, String sqlServerName);

    
Lists Azure SQL child resources of the specified Azure SQL server in the specified resource group.
Params:
sqlServer – the parent Azure SQL server.
Returns:
the list of resources/**
     * Lists Azure SQL child resources of the specified Azure SQL server in the specified resource group.
     *
     * @param sqlServer the parent Azure SQL server.
     * @return the list of resources
     */
    List<T> listBySqlServer(SqlServer sqlServer);

    
Asynchronously lists Azure SQL child resources of the specified Azure SQL server in the specified resource group.
Params:
sqlServer – the parent Azure SQL server.
Returns:
a representation of the deferred computation of this call/**
     * Asynchronously lists Azure SQL child resources of the specified Azure SQL server in the specified resource group.
     *
     * @param sqlServer the parent Azure SQL server.
     * @return a representation of the deferred computation of this call
     */
    @Beta(Beta.SinceVersion.V1_8_0)
    Observable<T> listBySqlServerAsync(SqlServer sqlServer);

    
Base interface for Azure SQL Server child resource actions.
Type parameters:
<T> – the FluentT interface of the SQL server child resource/**
     * Base interface for Azure SQL Server child resource actions.
     *
     * @param <T> the FluentT interface of the SQL server child resource
     */
    interface SqlChildrenActionsDefinition<T> {
        
Gets the information about a child resource from Azure SQL server.
Params:
name – the name of the child resource
Returns:
an immutable representation of the resource/**
         * Gets the information about a child resource from Azure SQL server.
         *
         * @param name the name of the child resource
         * @return an immutable representation of the resource
         */
        T get(String name);

        
Asynchronously gets the information about a child resource from Azure SQL server.
Params:
name – the name of the child resource
Returns:
a representation of the deferred computation of this call returning the found resource/**
         * Asynchronously gets the information about a child resource from Azure SQL server.
         *
         * @param name the name of the child resource
         * @return a representation of the deferred computation of this call returning the found resource
         */
        Observable<T> getAsync(String name);

        
Gets the information about a child resource from Azure SQL server using the resource ID.
Params:
id – the ID of the resource.
Returns:
an immutable representation of the resource/**
         * Gets the information about a child resource from Azure SQL server using the resource ID.
         *
         * @param id the ID of the resource.
         * @return an immutable representation of the resource
         */
        T getById(String id);

        
Asynchronously gets the information about a child resource from Azure SQL server using the resource ID.
Params:
id – the ID of the resource.
Returns:
an immutable representation of the resource/**
         * Asynchronously gets the information about a child resource from Azure SQL server using the resource ID.
         *
         * @param id the ID of the resource.
         * @return an immutable representation of the resource
         */
        Observable<T> getByIdAsync(String id);

        
Deletes a child resource from Azure SQL server.
Params:
name – the name of the child resource/**
         * Deletes a child resource from Azure SQL server.
         *
         * @param name the name of the child resource
         */
        void delete(String name);

        
Asynchronously delete a child resource from Azure SQL server.
Params:
name – the name of the child resource
Returns:
a representation of the deferred computation of this call/**
         * Asynchronously delete a child resource from Azure SQL server.
         *
         * @param name the name of the child resource
         * @return a representation of the deferred computation of this call
         */
        Completable deleteAsync(String name);

        
Deletes a child resource from Azure SQL server, identifying it by its resource ID.
Params:
id – the resource ID of the resource to delete/**
         * Deletes a child resource from Azure SQL server, identifying it by its resource ID.
         *
         * @param id the resource ID of the resource to delete
         */
        void deleteById(String id);

        
Asynchronously delete a child resource from Azure SQL server, identifying it by its resource ID.
Params:
id – the resource ID of the resource to delete
Returns:
a representation of the deferred computation of this call/**
         * Asynchronously delete a child resource from Azure SQL server, identifying it by its resource ID.
         *
         * @param id the resource ID of the resource to delete
         * @return a representation of the deferred computation of this call
         */
        Completable deleteByIdAsync(String id);

        
Lists Azure SQL child resources.
Returns:
the list of resources/**
         * Lists Azure SQL child resources.
         *
         * @return the list of resources
         */
        @Method
        List<T> list();

        
Asynchronously lists Azure SQL child resources.
Returns:
a representation of the deferred computation of this call/**
         * Asynchronously lists Azure SQL child resources.
         *
         * @return a representation of the deferred computation of this call
         */
        @Method
        Observable<T> listAsync();
    }
}