johnson-phillips/httplibrary

Purpose and Entry Points

A Java HTTP client library for GET/POST requests with two request-signing options: AWS Signature Version 4 and OAuth 1.0a. The consumer-facing request abstraction is src/main/java/http/HTTPRequest.java; OAuth usage is implemented through src/main/java/http/SimpleOauth10.java.

Request Orchestration

HTTPRequest is the primary control point: it represents an outbound HTTP request and likely owns method, URL, headers, body, connection execution, and response handling. Authorization logic should decorate or supply headers before this execution boundary. Paths: src/main/java/http/HTTPRequest.java, src/main/java/http/SimpleOauth10.java.

AWS SigV4 Signing Pipeline

AWS signing is separated into a reusable base plus an Authorization-header-specific signer. The pipeline constructs canonical request material, derives signing keys, calculates the signature, and emits an AWS Authorization header for the HTTP layer. Paths: src/main/java/awsauth/AWS4SignerBase.java, src/main/java/awsauth/AWS4SignerForAuthorizationHeader.java.

AWS Canonicalization Boundary

AWS-specific URL/query/header normalization is isolated from the generic HTTP client. HttpUtils handles HTTP-oriented canonicalization/encoding support, while BinaryUtils supports byte-level hashing or hex encoding used by signature generation. Paths: src/main/java/awsauth/HttpUtils.java, src/main/java/awsauth/BinaryUtils.java, src/main/java/awsauth/AWS4SignerBase.java.

OAuth 1.0a Flow

SimpleOauth10 provides the alternative authorization path: it generates OAuth request parameters and signature data, then integrates those values into the outbound request. This is a distinct credential/signature model from AWS SigV4 but shares the same HTTP transport boundary. Paths: src/main/java/http/SimpleOauth10.java, src/main/java/http/HTTPRequest.java.

Runtime and External Boundaries

The library runs on the JVM and is Maven-packaged as HttpLibrary version 1.0-SNAPSHOT. Its external boundary is arbitrary HTTP endpoints, including AWS services that accept SigV4 Authorization headers and OAuth 1.0a-protected APIs. Published Maven-style outputs, including a dependency-bundled JAR, are present under artifact/HttpLibrary/HttpLibrary/1.0-SNAPSHOT/.

Validation and Distribution

The available test entry point is src/test/java/HttpTest.java. Maven package metadata and distributable artifacts are tracked in pom.xml and artifact/HttpLibrary/HttpLibrary/1.0-SNAPSHOT/, indicating the project is intended for library consumption rather than as a standalone service.