Table of Contents
ToggleJava Base64 MimeEncoder Methods
提供 MIME 編碼器,是一種將非 ASCII 資料傳輸到電子郵件伺服器的規格,與 Base64 編碼類似,如果編碼的資料超過 76 個字元,則會資料將拆分為多行,每行最多包含 76 個字元,同時也使用 Apache Commons Codec 的實用 API 進行編碼, Base64 MimeEncoder Java Methods 本篇增加了範例,並透過單元測試來驗證產出結果。
檔案目錄
./
+- src
+- test
| +- org
| +- ruoxue
| +- java_147
| +- base64
| +- mime
| +- Base64MimeEncoderMethodsTest.java
單元測試
Base64 MimeEncoder Methods Java 提供 MIME 編碼器操作,將 byte[] 編碼成 Base64 。
encode
建立一個 String ,轉成 byte[] ,使用 Base64.MimeEncoder 進行編碼。
@Test
public void encode() throws Exception {
Base64.Encoder encoder = Base64.getMimeEncoder();
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
System.out.println(value);
byte[] result = encoder.encode(value.toString().getBytes(StandardCharsets.UTF_8.toString()));
System.out.println(result);
String stringResult = new String(result);
System.out.println(stringResult);
assertThat(stringResult).containsIgnoringNewLines(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv");
}
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/
[B@6aa8ceb6
QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0
NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4
eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx
cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv
encodeWithDst
Base64 MimeEncoder Methods Java 建立一個 String ,轉成 byte[] 使用 Base64.MimeEncoder 進行編碼,將結果存放到另一個陣列。
@Test
public void encodeWithDst() throws Exception {
Base64.Encoder encoder = Base64.getMimeEncoder();
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
System.out.println(value);
int size = 512;
byte[] dst = new byte[size];
int result = encoder.encode(value.toString().getBytes(StandardCharsets.UTF_8.toString()), dst);
System.out.println(result);
String stringResult = new String(dst);
System.out.println(stringResult);
assertThat(stringResult).containsIgnoringWhitespaces(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv")
.hasSize(size);
}
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/
262
QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0
NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4
eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx
cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv
encodeWithByteBuffer
Base64 MimeEncoder Methods Java 建立一個 String ,轉成 byte[] 包裝成 ByteBuffer ,使用 Base64.MimeEncoder 進行編碼,傳回 ByteBuffer 。
@Test
public void encodeWithByteBuffer() throws Exception {
Base64.Encoder encoder = Base64.getMimeEncoder();
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
ByteBuffer byteBuffer = ByteBuffer.wrap(value.toString().getBytes(StandardCharsets.UTF_8.toString()));
System.out.println(byteBuffer);
ByteBuffer result = encoder.encode(byteBuffer);
System.out.println(result);
String stringResult = new String(result.array(), StandardCharsets.UTF_8.toString());
System.out.println(stringResult);
assertThat(stringResult).containsIgnoringNewLines(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv");
}
java.nio.HeapByteBuffer[pos=0 lim=192 cap=192]
java.nio.HeapByteBuffer[pos=0 lim=262 cap=262]
QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0
NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4
eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx
cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv
encodeToString
Base64 MimeEncoder Methods 建立一個 String ,轉成 byte[] 使用 Base64.MimeEncoder 進行編碼,傳回字串。
@Test
public void encodeToString() throws Exception {
Base64.Encoder encoder = Base64.getMimeEncoder();
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
System.out.println(value);
String result = encoder.encodeToString(value.toString().getBytes(StandardCharsets.UTF_8.toString()));
System.out.println(result);
assertThat(result).containsIgnoringNewLines(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv");
}
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/
QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0
NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4
eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx
cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv
wrap
Base64 MimeEncoder Methods 建立一個檔案 ,使用 Base64.MimeEncoder 進行編碼,將結果輸出到另一個檔案。
@Test
public void wrap() throws Exception {
Path src = Paths.get("./", "build.gradle");
System.out.println(src);
Path dst = Paths.get("./", "bulid.log");
System.out.println(dst);
Base64.Encoder encoder = Base64.getMimeEncoder();
try (OutputStream output = Files.newOutputStream(dst)) {
long result = Files.copy(src, encoder.wrap(output));
System.out.println(result);
// OutputStream encodedStrem = encoder.wrap(output);
}
}
.\build.gradle
.\bulid.log
1582
Base64_encodeBase64
Base64 MimeEncoder Functions in Java 建立一個 String ,轉成 byte[] 使用 Apache Commons Codec 套件 Base64 進行編碼。
@Test
public void Base64_encodeBase64Chunked() throws Exception {
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
System.out.println(value);
byte[] result = org.apache.commons.codec.binary.Base64
.encodeBase64Chunked(value.toString().getBytes(StandardCharsets.UTF_8.toString()));
System.out.println(result);
String stringResult = new String(result);
System.out.println(stringResult);
assertThat(stringResult).containsIgnoringNewLines(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv");
}
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/
[B@4c98385c
QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0
NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4
eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx
cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv
Base64MimeEncoderMethodsTest.java
Base64 MimeEncoder Methods in Java 新增單元測試,驗證 Base64 MimeEncoder Functions in Java 是否符合預期。
package org.ruoxue.java_147.base64.mime;
import static org.assertj.core.api.Assertions.assertThat;
import java.io.OutputStream;
import java.nio.ByteBuffer;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Base64;
import org.junit.Test;
public class Base64MimeEncoderMethodsTest {
@Test
public void encode() throws Exception {
Base64.Encoder encoder = Base64.getMimeEncoder();
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
System.out.println(value);
byte[] result = encoder.encode(value.toString().getBytes(StandardCharsets.UTF_8.toString()));
System.out.println(result);
String stringResult = new String(result);
System.out.println(stringResult);
assertThat(stringResult).containsIgnoringNewLines(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv");
}
@Test
public void encodeWithDst() throws Exception {
Base64.Encoder encoder = Base64.getMimeEncoder();
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
System.out.println(value);
int size = 512;
byte[] dst = new byte[size];
int result = encoder.encode(value.toString().getBytes(StandardCharsets.UTF_8.toString()), dst);
System.out.println(result);
String stringResult = new String(dst);
System.out.println(stringResult);
assertThat(stringResult).containsIgnoringWhitespaces(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv")
.hasSize(size);
}
@Test
public void encodeWithByteBuffer() throws Exception {
Base64.Encoder encoder = Base64.getMimeEncoder();
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
ByteBuffer byteBuffer = ByteBuffer.wrap(value.toString().getBytes(StandardCharsets.UTF_8.toString()));
System.out.println(byteBuffer);
ByteBuffer result = encoder.encode(byteBuffer);
System.out.println(result);
String stringResult = new String(result.array(), StandardCharsets.UTF_8.toString());
System.out.println(stringResult);
assertThat(stringResult).containsIgnoringNewLines(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv");
}
@Test
public void encodeToString() throws Exception {
Base64.Encoder encoder = Base64.getMimeEncoder();
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
System.out.println(value);
String result = encoder.encodeToString(value.toString().getBytes(StandardCharsets.UTF_8.toString()));
System.out.println(result);
assertThat(result).containsIgnoringNewLines(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv");
}
@Test
public void wrap() throws Exception {
Path src = Paths.get("./", "build.gradle");
System.out.println(src);
Path dst = Paths.get("./", "bulid.log");
System.out.println(dst);
Base64.Encoder encoder = Base64.getMimeEncoder();
try (OutputStream output = Files.newOutputStream(dst)) {
long result = Files.copy(src, encoder.wrap(output));
System.out.println(result);
// OutputStream encodedStrem = encoder.wrap(output);
}
}
@Test
public void Base64_encodeBase64Chunked() throws Exception {
StringBuilder value = new StringBuilder();
for (int i = 0; i < 3; i++) {
value.append("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
}
System.out.println(value);
byte[] result = org.apache.commons.codec.binary.Base64
.encodeBase64Chunked(value.toString().getBytes(StandardCharsets.UTF_8.toString()));
System.out.println(result);
String stringResult = new String(result);
System.out.println(stringResult);
assertThat(stringResult).containsIgnoringNewLines(
"QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0\n"
+ "NTY3ODkrL0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4\n"
+ "eXowMTIzNDU2Nzg5Ky9BQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWmFiY2RlZmdoaWprbG1ub3Bx\n"
+ "cnN0dXZ3eHl6MDEyMzQ1Njc4OSsv");
}
}
心得分享
Base64 MimeEncoder Functions in Java 工具類別提供了一套靜態方法取得 MIME 編碼器,依照 RFC 2045 中指定的 Base64 字母表,輸出映射到一組字元A-Za-z0-9+/ ,超過 76 個字元,添加行分隔符號 \r\n ,輸出末尾不存在行分隔符號,熟悉 Base64 MimeEncoder Methods in Java 工具類別提供的靜態方法,取得 MIME 編碼器,進行編碼的操作。