Jinget.Handlers.ExternalServiceHandlers 6.2.19-preview013

Prefix Reserved
This is a prerelease version of Jinget.Handlers.ExternalServiceHandlers.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Jinget.Handlers.ExternalServiceHandlers --version 6.2.19-preview013
                    
NuGet\Install-Package Jinget.Handlers.ExternalServiceHandlers -Version 6.2.19-preview013
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Jinget.Handlers.ExternalServiceHandlers" Version="6.2.19-preview013" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Jinget.Handlers.ExternalServiceHandlers" Version="6.2.19-preview013" />
                    
Directory.Packages.props
<PackageReference Include="Jinget.Handlers.ExternalServiceHandlers" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Jinget.Handlers.ExternalServiceHandlers --version 6.2.19-preview013
                    
#r "nuget: Jinget.Handlers.ExternalServiceHandlers, 6.2.19-preview013"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Jinget.Handlers.ExternalServiceHandlers@6.2.19-preview013
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Jinget.Handlers.ExternalServiceHandlers&version=6.2.19-preview013&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Jinget.Handlers.ExternalServiceHandlers&version=6.2.19-preview013&prerelease
                    
Install as a Cake Tool

Jinget

We are currently in the way to make Jinget an open source project, during this journey we will publish different parts of Jinget

Jinget.Handlers.ExternalServiceHandlers

The purpose of this package is to facilitate communication and use of various types of web services and Web APIs including Rest APIs and SOAP web services.

How to Use:

  1. Download the package from NuGet using Package Manager: Install-Package Jinget.Handlers.ExternalServiceHandlers You can also use other methods supported by NuGet. Check Here for more information.

  2. Create a class which defines the response model.

     public class SampleGetResponse
     {
         public int id { get; set; }
         public string name { get; set; }
         public string username { get; set; }
    }
  1. Create an object of type JingetServiceHandler<> class and pass the response model as its generic type:
var jingetServiceHandler = new JingetServiceHandler<SampleGetResponse>("https://jsonplaceholder.typicode.com");
  1. Call your endpoint:
var result = await jingetServiceHandler.GetAsync("users");

How to call SOAP web Services:

  1. For SOAP services, it would be important to create the request envelope before sending the request. To create the request envelop, You need to create classes for different parts of the request envelop. For example suppose that we need to model the following request envelop:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:Add>
         <tem:intA>?</tem:intA>
         <tem:intB>?</tem:intB>
      </tem:Add>
   </soapenv:Body>
</soapenv:Envelope>

In this request envelop we have Envelop node which contains two inner nodes: Header and Body. Also for Body, this node contains a node node called Add and finally Add contains two nodes called intA and intB. Also each node belongs to some namespaces which are defined in Envelop node. With all these in mind, we need to define classes for exact this hierarchy as follow:

//This is the whole request envelop
public class SampleSOAPRequest : SOAPRequestBase<SampleSOAPRequest.Envelope, SampleSOAPRequest.SampleSOAPGet>
{
    //This method creates an envelop with the following structure
    public override (Envelope envelope, SampleSOAPGet request) CreateEnvelope()
    {
        var envelope = new Envelope
        {
            Header = new EnvelopeHeader(),
            Body = new EnvelopeBody()
        };
        return (envelope, envelope.Body.Add);
    }

    //request envelop contains the Envelop node with some namespaces
    [Serializable, XmlType(Namespace = "http://schemas.xmlsoap.org/soap/envelope/"), XmlRoot(Namespace = "http://schemas.xmlsoap.org/soap/envelope/")]
    public class Envelope : SOAPEnvelopeBase
    {
	    //When calling this method, the final envelop is returned as string value
        public override string ToString()
        {
            XmlSerializerNamespaces ns = new();
            ns.Add("tem", "http://tempuri.org/");
            ns.Add("soapenv", "http://schemas.xmlsoap.org/soap/envelope/");

            return XmlUtility.SerializeToXml(this, true, ns);
        }

        //Envelop node contains the Header node
        public EnvelopeHeader Header { get; set; }

        //Envelop node contains the Body node
        public EnvelopeBody Body { get; set; }
    }

    //The Header node has the following members. As you see it is empty. Also this node belongs to the http://schemas.xmlsoap.org/soap/envelope/ namespace
    [Serializable, XmlType(Namespace = "http://schemas.xmlsoap.org/soap/envelope/")]
    public class EnvelopeHeader
    {

    }

      //The Body node has the following members. Also this node belongs to the http://schemas.xmlsoap.org/soap/envelope/ namespace
    [Serializable, XmlType(Namespace = "http://schemas.xmlsoap.org/soap/envelope/")]
    public class EnvelopeBody
    {
	    //Body node contains a node called 'Add' which belongs to the http://schemas.xmlsoap.org/soap/envelope/ namespace
        [XmlElement(Namespace = "http://tempuri.org/")]
        public SampleSOAPGet Add { get; set; }
    }

     //The Add node has the following members.
    [Serializable]
    public class SampleSOAPGet
    {
        public int intA { get; set; }
        public int intB { get; set; }
    }
}
  1. Now that we have our envelop, we can easily call the SOAP web service as following:
var (envelope, request) = new SampleSOAPRequest().CreateEnvelope();
envelope.Body.Add = new SampleSOAPRequest.SampleSOAPGet { intA = 1, intB = 2 };

 var jingetServiceHandler = new JingetServiceHandler<ResponseType>("http://www.dneonline.com/calculator.asmx");

 var result = await jingetServiceHandler.PostAsync("", envelope.ToString(), true, new Dictionary<string, string>
 {
              {"Content-Type","text/xml" },
              {"SOAPAction","http://tempuri.org/Add" }
 });

In line number 2, we have our envelop and all we need to do, is to pass our parameters. In line number 6, the envelop is being send to the PostAsync method as string value. It is important to note the SOAPAction header.


How to use custom Service Handler

You can use your custom service handler instead of using JingetServiceHandler. To do this create your custom class and makes it to inherit from ServiceHandler<> class. Also create a custom class for your event management and pass it as generic argument to ServiceHandler<> class. For example suppose that we have a class called CustomHandler as below:

 public class CustomServiceHandler : ServiceHandler<CustomEvents>
 {
	...
 }

How to install

In order to install Jinget please refer to nuget.org

Further Information

Sample codes are available via Unit Test projects which are provided beside the main source codes.

Contact Me

👨‍💻 Twitter: https://twitter.com/_jinget

📧 Email: farahmandian2011@gmail.com

📣 Instagram: https://www.instagram.com/vahidfarahmandian

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Jinget.Handlers.ExternalServiceHandlers:

Package Downloads
Jinget.AzureDevOps.Connector

Using this package, you can easily connect to Azure DevOps and integrate it with your software applications

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
8.0.46 39 8/22/2025
8.0.45 116 7/31/2025
8.0.44 97 7/31/2025
8.0.43 94 7/30/2025
8.0.42 97 7/30/2025
8.0.41 94 7/30/2025
8.0.40 97 7/30/2025
8.0.39 100 7/29/2025
8.0.38 94 7/28/2025
8.0.37 97 7/28/2025
8.0.36 105 7/28/2025
8.0.36-preview005 104 7/27/2025
8.0.35 34 7/19/2025
8.0.34 34 7/18/2025
8.0.33 158 6/29/2025
8.0.32 147 6/29/2025
8.0.31 99 6/28/2025
8.0.30 67 6/27/2025
8.0.29 71 6/27/2025
8.0.28 75 6/27/2025
8.0.27 99 6/27/2025
8.0.26 114 6/21/2025
8.0.25 162 6/15/2025
8.0.25-preview001 144 6/15/2025
8.0.24 126 5/31/2025
8.0.23 153 5/28/2025
8.0.23-preview001 144 5/28/2025
8.0.22 163 5/25/2025
8.0.21 158 5/11/2025
8.0.20 146 5/11/2025
8.0.19 153 5/11/2025
8.0.18 183 4/21/2025
8.0.17 180 4/21/2025
8.0.16 118 4/19/2025
8.0.15 223 4/13/2025
8.0.14 196 4/7/2025
8.0.13 184 4/7/2025
8.0.12 124 4/5/2025
8.0.11 225 3/9/2025
8.0.10 194 3/9/2025
8.0.9 201 3/9/2025
8.0.8 179 2/27/2025
8.0.7 133 2/27/2025
8.0.6 128 2/27/2025
8.0.5 138 2/26/2025
8.0.4 133 2/25/2025
8.0.3 135 2/24/2025
8.0.2 132 2/24/2025
8.0.1 129 2/20/2025
8.0.0 133 1/22/2025
8.0.0-preview013 103 12/19/2024
8.0.0-preview012 110 12/19/2024
8.0.0-preview011 109 12/17/2024
8.0.0-preview010 114 12/16/2024
8.0.0-preview009 103 12/15/2024
8.0.0-preview008 98 11/25/2024
8.0.0-preview007 118 11/11/2024
8.0.0-preview006 107 11/2/2024
8.0.0-preview005 100 11/2/2024
8.0.0-preview004 114 11/1/2024
8.0.0-preview003 103 11/1/2024
8.0.0-preview002 102 11/1/2024
8.0.0-preview001 96 11/1/2024
6.2.23-preview003 105 10/31/2024
6.2.23-preview002 102 10/31/2024
6.2.22 146 10/26/2024
6.2.21 129 10/26/2024
6.2.20 128 10/26/2024
6.2.19-preview037 105 10/14/2024
6.2.19-preview036 105 9/30/2024
6.2.19-preview035 127 9/10/2024
6.2.19-preview034 120 9/9/2024
6.2.19-preview033 116 9/1/2024
6.2.19-preview032 112 9/1/2024
6.2.19-preview031 120 8/31/2024
6.2.19-preview029 117 8/26/2024
6.2.19-preview028 130 8/26/2024
6.2.19-preview027 136 8/26/2024
6.2.19-preview026 139 8/21/2024
6.2.19-preview025 140 8/21/2024
6.2.19-preview024 138 8/19/2024
6.2.19-preview023 120 8/8/2024
6.2.19-preview022 118 8/8/2024
6.2.19-preview021 115 8/5/2024
6.2.19-preview020 124 8/5/2024
6.2.19-preview019 111 8/5/2024
6.2.19-preview018 81 8/3/2024
6.2.19-preview017 77 7/30/2024
6.2.19-preview016 88 7/29/2024
6.2.19-preview015 91 7/29/2024
6.2.19-preview014 96 7/26/2024
6.2.19-preview013 120 7/20/2024
6.2.19-preview012 107 7/20/2024
6.2.19-preview011 116 6/15/2024
6.2.19-preview010 114 6/14/2024
6.2.19-preview009 112 6/14/2024
6.2.19-preview008 116 6/13/2024
6.2.19-preview007 111 6/13/2024
6.2.19-preview006 105 6/13/2024
6.2.19-preview005 94 6/13/2024
6.2.19-preview004 104 6/13/2024
6.2.19-preview003 117 6/11/2024
6.2.19-preview002 124 6/8/2024
6.2.19-preview001 121 6/8/2024
6.2.18 160 6/6/2024
6.2.18-preview020 127 6/6/2024
6.2.18-preview019 134 6/6/2024
6.2.18-preview018 155 6/6/2024
6.2.18-preview017 129 6/2/2024
6.2.18-preview016 129 6/1/2024
6.2.18-preview015 138 5/28/2024
6.2.18-preview014 124 5/28/2024
6.2.18-preview013 128 5/28/2024
6.2.18-preview012 124 5/28/2024
6.2.18-preview011 118 5/26/2024
6.2.18-preview010 122 5/26/2024
6.2.18-preview009 120 5/26/2024
6.2.18-preview008 129 5/26/2024
6.2.18-preview007 132 5/22/2024
6.2.18-preview006 131 5/22/2024
6.2.18-preview005 114 5/19/2024
6.2.18-preview004 106 5/19/2024
6.2.18-preview003 103 5/19/2024
6.2.18-preview002 104 5/19/2024
6.2.17 118 5/19/2024
6.2.16 122 5/18/2024
6.2.15 131 5/18/2024
6.2.14 125 5/18/2024
6.2.13 132 5/17/2024
6.2.12 131 5/17/2024
6.2.11 133 5/17/2024
6.2.10 141 5/17/2024
6.2.9 154 5/12/2024
6.2.8 162 5/9/2024
6.2.7 167 5/9/2024
6.2.6 166 5/7/2024
6.2.5 146 4/24/2024
6.2.4 179 2/1/2024
6.2.3 154 2/1/2024
6.2.2 147 1/31/2024
6.2.1 162 1/23/2024
6.2.0 160 1/23/2024
6.2.0-preview013 130 1/19/2024
6.2.0-preview012 135 1/19/2024
6.2.0-preview011 138 1/18/2024
6.2.0-preview010 144 1/14/2024
6.2.0-preview009 149 1/11/2024
6.2.0-preview008 157 1/1/2024
6.2.0-preview007 141 1/1/2024
6.2.0-preview006 143 1/1/2024
6.2.0-preview005 152 1/1/2024
6.2.0-preview001 148 12/30/2023
6.1.0 251 12/2/2023
6.1.0-preview003 170 12/2/2023
6.1.0-preview002 164 12/2/2023
6.1.0-preview001 168 12/2/2023
6.0.2 182 11/27/2023
6.0.1 193 11/22/2023
6.0.0 164 11/22/2023
3.5.0 230 10/28/2023
3.4.0 238 10/1/2023
3.3.1 221 9/30/2023
3.3.0 197 9/28/2023
3.2.5 207 9/28/2023
3.2.4 212 9/28/2023
3.2.3 200 9/28/2023
3.2.2 208 9/28/2023
3.2.1 187 9/28/2023
3.2.0 208 9/28/2023
3.1.0 213 9/27/2023
3.0.1 196 9/27/2023
3.0.0 218 9/14/2023
3.0.0-preview001 193 9/14/2023
2.3.2 236 9/12/2023
2.3.1 287 8/20/2023
2.3.0 272 8/20/2023
2.2.0 254 8/12/2023
2.1.1 294 8/5/2023
2.1.0 268 8/5/2023
2.0.5 248 7/20/2023
2.0.4 257 7/15/2023
2.0.3 691 7/1/2023
2.0.1 262 7/1/2023
2.0.0 293 6/29/2023