萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

.NET 使用 HttpWebRequest 透過 URL 推送 POST 資料完整實作

前言

在企業系統整合情境中,常需主動將資料以 HTTP POST 方式推送至第三方 API。本文示範在 ASP.NET (C#) 中使用 HttpWebRequest 組裝 XML 承載、設定標頭、處理串流與回應的完整流程,並說明 MemoryStream 替代 Stream 避免長度不可搜尋的常見坑點。

一、Web.config 存放目標 URL

<appSettings>
  <add key="PushApiUrl" value="https://api.partner.com/receive" />
</appSettings>

二、核心推送邏輯

using System;
using System.IO;
using System.Net;
using System.Text;
using System.Web;
using System.Xml.Linq;

public class PushService
{
    private readonly string _apiUrl;

    public PushService()
    {
        _apiUrl = System.Configuration.ConfigurationManager.AppSettings["PushApiUrl"];
    }

    /// 
    /// 將消費紀錄以 XML 格式 POST 推送至外部 API
    /// 
    public string PushConsumption(ConsumptionRecord consumption)
    {
        // 1. 組裝 XML 承載
        string xmlBody = $@"<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<Body>
  <ValidId>{consumption.Id}</ValidId>
  <OrderId>{consumption.Order.AgentOrderId}</OrderId>
  <Count>{consumption.Count}</Count>
  <ValidTime>{consumption.CreateTime:yyyy-MM-dd HH:mm:ss}</ValidTime>
  <Remark/>
</Body>";

        string requestXml = BuildRequestEnvelope(xmlBody);

        // 2. 建立 HttpWebRequest
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(_apiUrl);
        request.Method = "POST";
        request.Headers.Add("X-Auth-Token", HttpUtility.UrlEncode("openstack"));
        request.ContentType = "application/xml"; // 依實際 API 調整
        request.AllowAutoRedirect = true;

        // 3. 寫入請求串流:使用 MemoryStream 避免 Stream 不支援 Length/Position
        byte[] payloadBytes = Encoding.UTF8.GetBytes(requestXml);
        using (MemoryStream memStream = new MemoryStream())
        {
            memStream.Write(payloadBytes, 0, payloadBytes.Length);
            request.ContentLength = memStream.Length;

            using (Stream reqStream = request.GetRequestStream())
            {
                memStream.Position = 0;
                memStream.CopyTo(reqStream);
            }
        }

        // 4. 取得回應並處理編碼
        using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
        using (Stream respStream = response.GetResponseStream())
        using (StreamReader reader = new StreamReader(respStream, Encoding.GetEncoding("UTF-8"), true))
        {
            string rawResponse = reader.ReadToEnd();
            // 若回應為 Base64 加密的 XML,需解密解析
            return ProcessResponse(rawResponse);
        }
    }

    private string BuildRequestEnvelope(string bodyXml)
    {
        // 依對方規格包裝 SOAP 或自訂信封,此處略
        return bodyXml;
    }

    private string ProcessResponse(string raw)
    {
        // 範例:解密、解析 XML、提取 UseId
        // string decrypted = TCodeServiceCrypt.Decrypt3DESFromBase64(...);
        // XDocument doc = XDocument.Parse(decrypted);
        // return doc.Element("Body").Element("UseId").Value;
        return raw; // 簡化
    }
}

public class ConsumptionRecord
{
    public int Id { get; set; }
    public OrderInfo Order { get; set; }
    public int Count { get; set; }
    public DateTime CreateTime { get; set; }
}

public class OrderInfo
{
    public string AgentOrderId { get; set; }
}

三、關鍵技術點解析

1. 為何改用 MemoryStream?

直接使用 request.GetRequestStream() 取得的 Stream 不支援 Length 與 Position 屬性,導致無法預先設定 ContentLength 或重設位置。MemoryStream 完整支援搜尋操作,寫入後再 CopyTo 至請求串流即可。

2. 編碼一致性

  • 請求端:Encoding.UTF8.GetBytes 產生 Byte 陣列。
  • 回應端:StreamReader 指定 Encoding.UTF8 讀取,避免預設 Default 編碼導致中文亂碼。

3. 安全性與健壯性建議

  • 正式環境請啟用 TLS 1.2+:ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;
  • 設定 request.Timeout 與 request.ReadWriteTimeout 防止卡死。
  • 記錄請求/回應內容(去敏後)供事後追蹤。
  • 考慮改用 HttpClient ( .NET 4.5+ ) 簡化非同步與連線池管理。

四、非同步版本範例 ( .NET 4.5+ )

public async Task<string> PushConsumptionAsync(ConsumptionRecord consumption)
{
    string xmlBody = BuildXmlBody(consumption);
    using (HttpClient client = new HttpClient())
    {
        client.DefaultRequestHeaders.Add("X-Auth-Token", "openstack");
        HttpContent content = new StringContent(xmlBody, Encoding.UTF8, "application/xml");
        HttpResponseMessage resp = await client.PostAsync(_apiUrl, content);
        resp.EnsureSuccessStatusCode();
        return await resp.Content.ReadAsStringAsync();
    }
}
copyright © 萬盛學電腦網 all rights reserved