/* SPDX-License-Identifier: Apache-2.0 * * The OpenSearch Contributors require contributions made to * this file be licensed under the Apache-2.0 license or a * compatible open source license. */ /* * Modifications Copyright OpenSearch Contributors. See * GitHub history for details. * * Licensed to Elasticsearch B.V. under one or more contributor * license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright * ownership. Elasticsearch B.V. licenses this file to you under * the Apache License, Version 2.0 (the "License"); you may * not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ using System; using System.Collections.Generic; using System.Linq.Expressions; using System.Runtime.Serialization; using OpenSearch.Net.Utf8Json; namespace OpenSearch.Client.Specification.IngestApi { /// /// The user_agent processor extracts details from the user agent string a browser sends with its web requests. /// This processor adds this information by default under the user_agent field. /// The ingest-user-agent plugin ships by default with the regexes.yaml made available by /// uap-java with an Apache 2.0 license. /// /// /// Requires the UserAgent Processor Plugin to be installed on the cluster. /// [InterfaceDataContract] public interface IUserAgentProcessor : IProcessor { [DataMember(Name ="field")] Field Field { get; set; } /// /// If `true` and `field` does not exist, the processor quietly exits without modifying the document /// [DataMember(Name ="ignore_missing")] bool? IgnoreMissing { get; set; } [DataMember(Name ="options")] IEnumerable Properties { get; set; } [DataMember(Name ="regex_file")] string RegexFile { get; set; } [DataMember(Name ="target_field")] Field TargetField { get; set; } } /// public class UserAgentProcessor : ProcessorBase, IUserAgentProcessor { /// public Field Field { get; set; } /// public bool? IgnoreMissing { get; set; } /// public IEnumerable Properties { get; set; } /// public string RegexFile { get; set; } /// public Field TargetField { get; set; } protected override string Name => "user_agent"; } /// public class UserAgentProcessorDescriptor : ProcessorDescriptorBase, IUserAgentProcessor>, IUserAgentProcessor where T : class { protected override string Name => "user_agent"; Field IUserAgentProcessor.Field { get; set; } bool? IUserAgentProcessor.IgnoreMissing { get; set; } IEnumerable IUserAgentProcessor.Properties { get; set; } string IUserAgentProcessor.RegexFile { get; set; } Field IUserAgentProcessor.TargetField { get; set; } /// public UserAgentProcessorDescriptor Field(Field field) => Assign(field, (a, v) => a.Field = v); /// public UserAgentProcessorDescriptor Field(Expression> objectPath) => Assign(objectPath, (a, v) => a.Field = v); /// public UserAgentProcessorDescriptor TargetField(Field field) => Assign(field, (a, v) => a.TargetField = v); /// public UserAgentProcessorDescriptor TargetField(Expression> objectPath) => Assign(objectPath, (a, v) => a.TargetField = v); /// public UserAgentProcessorDescriptor RegexFile(string file) => Assign(file, (a, v) => a.RegexFile = v); /// public UserAgentProcessorDescriptor IgnoreMissing(bool? ignoreMissing = true) => Assign(ignoreMissing, (a, v) => a.IgnoreMissing = v); /// public UserAgentProcessorDescriptor Properties(IEnumerable properties) => Assign(properties, (a, v) => a.Properties = v); /// public UserAgentProcessorDescriptor Properties(params UserAgentProperty[] properties) => Assign(properties, (a, v) => a.Properties = v); } }