Exemple #1
0
 /// <summary>
 ///     Performs a POST request with the body consisting of a series of key-value arguments.</summary>
 /// <param name="url">
 ///     The URL of the request. If the URL does not begin with <c>http://</c> or <c>https://</c>, it is automatically
 ///     prepended with <see cref="RootUrl"/>.</param>
 /// <param name="args">
 ///     The arguments to pass with the POST request. Null values are allowed and ignored.</param>
 /// <returns>
 ///     The response received from the server.</returns>
 /// <remarks>
 ///     This method automatically calls either <see cref="PostFormdata"/> or <see cref="PostUrlencoded"/> depending on
 ///     whether the provided arguments contain any file uploads or not.</remarks>
 public HResponse Post(string url, params HArg[] args)
 {
     if (args == null)
     {
         args = new HArg[0];
     }
     return(args.Where(a => a != null).All(a => a.ValidForUrlEncoded) ? PostUrlencoded(url, args) : PostFormdata(url, args));
 }
Exemple #2
0
        /// <summary>
        ///     Performs a POST request with the body consisting of a series of key-value arguments, encoded in the
        ///     <c>application/x-www-form-urlencoded</c> format.</summary>
        /// <param name="url">
        ///     The URL of the request. If the URL does not begin with <c>http://</c> or <c>https://</c>, it is automatically
        ///     prepended with <see cref="RootUrl"/>.</param>
        /// <param name="args">
        ///     The arguments to pass with the POST request. Null values are allowed and ignored.</param>
        /// <returns>
        ///     The response received from the server.</returns>
        /// <remarks>
        ///     Choose this format for requests that need to be small and do not contain any file uploads.</remarks>
        /// <seealso cref="Post(string,HArg[])"/>
        public HResponse PostUrlencoded(string url, params HArg[] args)
        {
            if (args == null)
            {
                args = new HArg[0];
            }
            var invalid = args.Where(a => a != null).FirstOrDefault(a => !a.ValidForUrlEncoded);

            if (invalid != null)
            {
                throw new ArgumentException("args", "The argument with name '{0}' is not valid for URL-encoded POST requests.".Fmt(invalid.Name));
            }
            return(Post(url, args.Where(a => a != null).Select(a => a.Name.UrlEscape() + "=" + a.Value.UrlEscape()).JoinString("&").ToUtf8(),
                        "application/x-www-form-urlencoded"));
        }
Exemple #3
0
        /// <summary>
        ///     Performs a GET request to the specified URL and with the specified query parameters.</summary>
        /// <param name="url">
        ///     The URL of the request. If the URL does not begin with <c>http://</c> or <c>https://</c>, it is automatically
        ///     prepended with <see cref="RootUrl"/>.</param>
        /// <param name="args">
        ///     Query parameters to add to the end of the URL in the usual <c>?k1=v1&amp;k2=v2&amp;...</c> format. Null values
        ///     are allowed and ignored.</param>
        /// <returns>
        ///     The response received from the server.</returns>
        public HResponse Get(string url, params HArg[] args)
        {
            if (args == null)
            {
                args = new HArg[0];
            }
            if (!args.Where(a => a != null).All(a => a.ValidForUrlEncoded))
            {
                throw new ArgumentException();
            }
            var request = makeRequest(url + (args.Where(a => a != null).Any() ? (url.Contains('?') ? "&" : "?") : "") + args.Where(a => a != null).Select(a => a.Name.UrlEscape() + "=" + a.Value.UrlEscape()).JoinString("&"));

            request.Method = "GET";
            return(performRequest(request));
        }
Exemple #4
0
        /// <summary>
        ///     Performs a POST request with the body consisting of a series of key-value arguments, encoded in the
        ///     <c>multipart/form-data</c> format.</summary>
        /// <param name="url">
        ///     The URL of the request. If the URL does not begin with <c>http://</c> or <c>https://</c>, it is automatically
        ///     prepended with <see cref="RootUrl"/>.</param>
        /// <param name="args">
        ///     The arguments to pass with the POST request. Null values are allowed and ignored.</param>
        /// <returns>
        ///     The response received from the server.</returns>
        /// <remarks>
        ///     Choose this format for requests that need to contain file uploads.</remarks>
        /// <seealso cref="Post(string,HArg[])"/>
        public HResponse PostFormdata(string url, params HArg[] args)
        {
            if (args == null)
            {
                args = new HArg[0];
            }
            var invalid = args.Where(a => a != null).FirstOrDefault(a => !a.Valid);

            if (invalid != null)
            {
                throw new ArgumentException("args", "The argument with name '{0}' is not valid.".Fmt(invalid.Name));
            }

            string boundary = Rnd.NextBytes(20).ToHex();

            var ms = new MemoryStream(300 + args.Where(a => a != null).Sum(a => 30 + a.Name.Length + (a.FileContent == null ? a.Value.Length : a.FileContent.Length)));
            var sw = new StreamWriter(ms);

            sw.AutoFlush = true;
            foreach (var arg in args.Where(a => a != null))
            {
                if (arg.FileContent == null)
                {
                    sw.WriteLine("--" + boundary);
                    sw.WriteLine(@"Content-Disposition: form-data; name=""" + arg.Name + @"""");
                    sw.WriteLine();
                    sw.WriteLine(arg.Value);
                }
                else
                {
                    sw.WriteLine("--" + boundary);
                    sw.WriteLine(@"Content-Disposition: form-data; name=""" + arg.Name + @"""; filename=""" + arg.FileName + @"""");
                    sw.WriteLine(@"Content-Type: " + arg.FileContentType);
                    sw.WriteLine();
                    ms.Write(arg.FileContent);
                    sw.WriteLine();
                }
            }
            sw.WriteLine("--" + boundary + "--");

            return(Post(url, ms.ToArray(), "multipart/form-data; boundary=" + boundary));
        }
Exemple #5
0
        /// <summary>
        ///     Performs a POST request with the body consisting of a series of key-value arguments, encoded in the
        ///     <c>multipart/form-data</c> format.</summary>
        /// <param name="url">
        ///     The URL of the request. If the URL does not begin with <c>http://</c> or <c>https://</c>, it is automatically
        ///     prepended with <see cref="RootUrl"/>.</param>
        /// <param name="args">
        ///     The arguments to pass with the POST request. Null values are allowed and ignored.</param>
        /// <returns>
        ///     The response received from the server.</returns>
        /// <remarks>
        ///     Choose this format for requests that need to contain file uploads.</remarks>
        /// <seealso cref="Post(string,HArg[])"/>
        public HResponse PostFormdata(string url, params HArg[] args)
        {
            if (args == null)
                args = new HArg[0];
            var invalid = args.Where(a => a != null).FirstOrDefault(a => !a.Valid);
            if (invalid != null)
                throw new ArgumentException("args", "The argument with name '{0}' is not valid.".Fmt(invalid.Name));

            string boundary = Rnd.NextBytes(20).ToHex();

            var ms = new MemoryStream(300 + args.Where(a => a != null).Sum(a => 30 + a.Name.Length + (a.FileContent == null ? a.Value.Length : a.FileContent.Length)));
            var sw = new StreamWriter(ms);
            sw.AutoFlush = true;
            foreach (var arg in args.Where(a => a != null))
            {
                if (arg.FileContent == null)
                {
                    sw.WriteLine("--" + boundary);
                    sw.WriteLine(@"Content-Disposition: form-data; name=""" + arg.Name + @"""");
                    sw.WriteLine();
                    sw.WriteLine(arg.Value);
                }
                else
                {
                    sw.WriteLine("--" + boundary);
                    sw.WriteLine(@"Content-Disposition: form-data; name=""" + arg.Name + @"""; filename=""" + arg.FileName + @"""");
                    sw.WriteLine(@"Content-Type: " + arg.FileContentType);
                    sw.WriteLine();
                    ms.Write(arg.FileContent);
                    sw.WriteLine();
                }
            }
            sw.WriteLine("--" + boundary + "--");

            return Post(url, ms.ToArray(), "multipart/form-data; boundary=" + boundary);
        }
Exemple #6
0
 /// <summary>
 ///     Performs a POST request with the body consisting of a series of key-value arguments, encoded in the
 ///     <c>application/x-www-form-urlencoded</c> format.</summary>
 /// <param name="url">
 ///     The URL of the request. If the URL does not begin with <c>http://</c> or <c>https://</c>, it is automatically
 ///     prepended with <see cref="RootUrl"/>.</param>
 /// <param name="args">
 ///     The arguments to pass with the POST request. Null values are allowed and ignored.</param>
 /// <returns>
 ///     The response received from the server.</returns>
 /// <remarks>
 ///     Choose this format for requests that need to be small and do not contain any file uploads.</remarks>
 /// <seealso cref="Post(string,HArg[])"/>
 public HResponse PostUrlencoded(string url, params HArg[] args)
 {
     if (args == null)
         args = new HArg[0];
     var invalid = args.Where(a => a != null).FirstOrDefault(a => !a.ValidForUrlEncoded);
     if (invalid != null)
         throw new ArgumentException("args", "The argument with name '{0}' is not valid for URL-encoded POST requests.".Fmt(invalid.Name));
     return Post(url, args.Where(a => a != null).Select(a => a.Name.UrlEscape() + "=" + a.Value.UrlEscape()).JoinString("&").ToUtf8(),
         "application/x-www-form-urlencoded");
 }
Exemple #7
0
 /// <summary>
 ///     Performs a POST request with the body consisting of a series of key-value arguments.</summary>
 /// <param name="url">
 ///     The URL of the request. If the URL does not begin with <c>http://</c> or <c>https://</c>, it is automatically
 ///     prepended with <see cref="RootUrl"/>.</param>
 /// <param name="args">
 ///     The arguments to pass with the POST request. Null values are allowed and ignored.</param>
 /// <returns>
 ///     The response received from the server.</returns>
 /// <remarks>
 ///     This method automatically calls either <see cref="PostFormdata"/> or <see cref="PostUrlencoded"/> depending on
 ///     whether the provided arguments contain any file uploads or not.</remarks>
 public HResponse Post(string url, params HArg[] args)
 {
     if (args == null)
         args = new HArg[0];
     return args.Where(a => a != null).All(a => a.ValidForUrlEncoded) ? PostUrlencoded(url, args) : PostFormdata(url, args);
 }
Exemple #8
0
 /// <summary>
 ///     Performs a GET request to the specified URL and with the specified query parameters.</summary>
 /// <param name="url">
 ///     The URL of the request. If the URL does not begin with <c>http://</c> or <c>https://</c>, it is automatically
 ///     prepended with <see cref="RootUrl"/>.</param>
 /// <param name="args">
 ///     Query parameters to add to the end of the URL in the usual <c>?k1=v1&amp;k2=v2&amp;...</c> format. Null values
 ///     are allowed and ignored.</param>
 /// <returns>
 ///     The response received from the server.</returns>
 public HResponse Get(string url, params HArg[] args)
 {
     if (args == null)
         args = new HArg[0];
     if (!args.Where(a => a != null).All(a => a.ValidForUrlEncoded))
         throw new ArgumentException();
     var request = makeRequest(url + (args.Where(a => a != null).Any() ? (url.Contains('?') ? "&" : "?") : "") + args.Where(a => a != null).Select(a => a.Name.UrlEscape() + "=" + a.Value.UrlEscape()).JoinString("&"));
     request.Method = "GET";
     return performRequest(request);
 }