import { Base } from "./base";
import { ITextProcessor, IQuestion, ISurvey } from "./base-interfaces";
import { ItemValue } from "./itemvalue";
import { IBeforeRequestChoicesOptions } from "./settings";
import { SurveyError } from "./survey-error";
/**
 * Configures access to a RESTful service that returns choices for [Checkbox](https://surveyjs.io/Examples/Library?id=questiontype-checkbox), [Dropdown](https://surveyjs.io/Examples/Library?id=questiontype-dropdown), [Radiogroup](https://surveyjs.io/Examples/Library?id=questiontype-radiogroup), and other multiple-choice question types.
 *
 * Use the following properties to configure this object:
 *
 * ```js
 * {
 *   url: "http://...", // A RESTful service's URL.
 *   valueName: "value", // Specifies which field contains choice values.
 *   titleName: "title", // Specifies which field contains display texts for choice values.
 *   imageLinkName: "imageUrl", // Specifies which field contains image URLs. Used in Image Picker questions.
 *   // Path to the array of choices. Specify `path` only if the array of choices is nested within the object returned by the service.
 *   // The following path separators are allowed: semicolon `;`, comma `,`.
 *   path: "myNestedArray"
 * }
 * ```
 *
 * Typically, you should assign this object to a question's [`choicesByUrl`](https://surveyjs.io/Documentation/Library?id=QuestionSelectBase#choicesByUrl) property. You can also specify additional application-wide settings using the [`settings.web`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) object.
 */
export declare class ChoicesRestful extends Base {
    private static cacheText;
    private static noCacheText;
    static get EncodeParameters(): boolean;
    static set EncodeParameters(val: boolean);
    static clearCache(): void;
    private static itemsResult;
    private static sendingSameRequests;
    private static addSameRequest;
    private static unregisterSameRequests;
    static get onBeforeSendRequest(): (sender: ChoicesRestful, options: IBeforeRequestChoicesOptions) => void;
    static set onBeforeSendRequest(val: (sender: ChoicesRestful, options: IBeforeRequestChoicesOptions) => void);
    private static getCachedItemsResult;
    private lastObjHash;
    private isRunningValue;
    protected processedUrl: string;
    protected processedPath: string;
    private isUsingCacheFromUrl;
    onProcessedUrlCallback: (url: string, path: string) => void;
    getResultCallback: (items: Array<ItemValue>) => void;
    beforeSendRequestCallback: () => void;
    updateResultCallback: (items: Array<ItemValue>, serverResult: any) => Array<ItemValue>;
    getItemValueCallback: (item: any) => any;
    error: SurveyError;
    owner: IQuestion;
    createItemValue: (value: any) => ItemValue;
    protected onPropertyValueChanged(name: string, oldValue: any, newValue: any): void;
    getSurvey(live?: boolean): ISurvey;
    run(textProcessor?: ITextProcessor): void;
    get isUsingCache(): boolean;
    get isRunning(): boolean;
    protected getIsRunning(): boolean;
    get isWaitingForParameters(): boolean;
    protected useChangedItemsResults(): boolean;
    private doEmptyResultCallback;
    private processedText;
    protected parseResponse(response: any): any;
    protected sendRequest(): void;
    protected sendXmlHttpRequest(): void;
    protected sendFetchRequest(): void;
    getType(): string;
    get isEmpty(): boolean;
    getCustomPropertiesNames(): Array<string>;
    private getCustomPropertyName;
    private getCustomProperties;
    private getAllPropertiesNames;
    setData(json: any): void;
    getData(): any;
    /**
     * A RESTful service's URL.
     *
     * This property supports [dynamic URLs](https://surveyjs.io/Documentation/Library?id=design-survey-conditional-logic#dynamic-texts). For example, the URL below depends on the `region` question's value. When the value changes, the survey automatically loads a new dataset that corresponds to the selected region.
     *
     * ```js
     * url: "https://surveyjs.io/api/CountriesExample?region={region}"
     * ```
     *
     * [View Demo](https://surveyjs.io/Examples/Library/?id=questiontype-dropdownrestfull (linkStyle))
     * @see path
     * @see valueName
     * @see titleName
     */
    get url(): string;
    set url(val: string);
    /**
     * Path to the array of choices. The following path separators are allowed: semicolon `;`, comma `,`.
     *
     * Specify this property only if the array of choices is nested within the object returned by the service. For example, the service returns the following object:
     *
     * ```js
     * {
     *   countries: [ ... ],
     *   capitals: [ ... ]
     * }
     * ```
     *
     * To populate choices with values from the `countries` array, set the `path` property to `"countries"`. To use the `capitals` array, set this property to `"capitals"`.
     * @see url
     * @see valueName
     * @see titleName
     */
    get path(): string;
    set path(val: string);
    /**
     * Specifies which property in the obtained data object contains choice values.
     *
     * [View Demo](https://surveyjs.io/Examples/Library/?id=questiontype-dropdownrestfull (linkStyle))
     *
     * @see url
     * @see path
     * @see titleName
     */
    get valueName(): string;
    set valueName(val: string);
    /**
     * Specifies which property in the obtained data object contains display texts for choices.
     *
     * @see url
     * @see path
     * @see valueName
     */
    get titleName(): string;
    set titleName(val: string);
    /**
     * Specifies which property in the obtained data object contains image URLs. Used only in [Image Picker](https://surveyjs.io/Examples/Library?id=questiontype-imagepicker) questions.
     *
     * @see url
     * @see path
     * @see valueName
     */
    get imageLinkName(): string;
    set imageLinkName(val: string);
    /**
     * Specifies whether the service is allowed to return an empty response or an empty array in a response.
     *
     * Default value: `false`
     */
    get allowEmptyResponse(): boolean;
    set allowEmptyResponse(val: boolean);
    get attachOriginalItems(): boolean;
    set attachOriginalItems(val: boolean);
    /**
     * Specifies whether to attach original data objects to choice items.
     *
     * Default value: `false`
     *
     * If you enable this property, original data objects will be stored in the `data` property of choice items. For instance, the following code shows how to access a data object of a selected choice item in a Dropdown question:
     *
     * ```js
     * import { Model } from "survey-core";
     *
     * const surveyJson = {
     *   "elements": [{
     *     "type": "dropdown",
     *     "name": "country",
     *     "title": "Select a country",
     *     "choicesByUrl": {
     *       "url": "https://surveyjs.io/api/CountriesExample",
     *       "valueName": "name",
     *       "attachData": true
     *     }
     *   }]
     * }
     *
     * const survey = new Model(surveyJson);
     *
     * function retrieveItemData(survey, qName) {
     *   const q = survey.getQuestionByName(qName);
     *   if (q && q.selectedItem) {
     *     return q.selectedItem.data;
     *   }
     *   return null;
     * }
     * ```
     */
    get attachData(): boolean;
    set attachData(val: boolean);
    get itemValueType(): string;
    clear(): void;
    protected beforeSendRequest(): void;
    protected beforeLoadRequest(): void;
    protected onLoad(result: any, loadingObjHash?: string): void;
    protected callResultCallback(items: Array<ItemValue>, loadingObjHash: string): void;
    private setCustomProperties;
    private getPropertyBinding;
    private onError;
    private getResultAfterPath;
    private getPathes;
    private getValue;
    private setTitle;
    private getImageLink;
    private getValueCore;
    private get objHash();
}
/**
 * @deprecated Use `ChoicesRestful` instead.
 */
export declare class ChoicesRestfull extends ChoicesRestful {
    static get EncodeParameters(): boolean;
    static set EncodeParameters(val: boolean);
    static clearCache(): void;
    static get onBeforeSendRequest(): (sender: ChoicesRestful, options: IBeforeRequestChoicesOptions) => void;
    static set onBeforeSendRequest(val: (sender: ChoicesRestful, options: IBeforeRequestChoicesOptions) => void);
}
