excelfreedom

freedom utilities

License	License MIT License
GroupId	GroupId com.github.nut077
ArtifactId	ArtifactId excelfreedom
Last Version	Last Version 1.0.0
Release Date	Release Date May 15, 2018
Type	Type jar
Description	Description excelfreedom freedom utilities
Project URL	Project URL https://github.com/nut077/excelfreedom/
Source Code Management	Source Code Management https://github.com/nut077/excelfreedom

Download excelfreedom

Filename	Size
excelfreedom-1.0.0.pom
excelfreedom-1.0.0.jar	27 KB
excelfreedom-1.0.0-sources.jar	10 KB
excelfreedom-1.0.0-javadoc.jar	364 KB
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.nut077/excelfreedom/ -->
<dependency>
    <groupId>com.github.nut077</groupId>
    <artifactId>excelfreedom</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.nut077/excelfreedom/
implementation 'com.github.nut077:excelfreedom:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.nut077/excelfreedom/
implementation ("com.github.nut077:excelfreedom:1.0.0")

Apache Buildr

'com.github.nut077:excelfreedom:jar:1.0.0'

Apache Ivy

<dependency org="com.github.nut077" name="excelfreedom" rev="1.0.0">
  <artifact name="excelfreedom" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.nut077', module='excelfreedom', version='1.0.0')
)

Scala SBT

libraryDependencies += "com.github.nut077" % "excelfreedom" % "1.0.0"

Leiningen

[com.github.nut077/excelfreedom "1.0.0"]

Dependencies

compile (4)

Group / Artifact	Type	Version
net.sourceforge.jexcelapi : jxl	jar	2.6.12
javax.servlet : servlet-api	jar	2.5
javax.servlet.jsp : javax.servlet.jsp-api	jar	2.3.1
com.github.nut077 : freedom-utilities	jar	1.0.0

Project Modules

There are no modules declared in this project.

Tutorial ExcelFreedom

maven

<!-- https://mvnrepository.com/artifact/com.github.nut077/excel-freedom -->
<dependency>
    <groupId>com.github.nut077</groupId>
    <artifactId>excel-freedom</artifactId>
    <version>1.0.3</version>
</dependency>

รูปแบบการใช้งาน
<table></table> คือ 1 sheet <tr></tr> คือ 1 แถว <td></td> คือ 1 column

StringBuilder table = new StringBuilder();
table.append("<table>");
  table.append("<tr>");
    table.append("<td>A</td>");
    table.append("<td>B</td>");
    table.append("<td>C</td>");
  table.append("</tr>");
table.append("</table>");
// ใช้งานแบบ offline
// parameter ตัวแรกคือที่อยู่ของไฟล์ที่จะสร้าง ตัวที่สองคือชื่อของไฟล์ excel และตัวสุดท้ายคือข้อมูลที่จะเขียนลงในไฟล์ excel
ExcelFreedom excelFreedom = new ExcelFreedom("D://", "excel", table.toString());

// ใช้งานแบบ servlets ไฟล์ jsp
// parameter ตัวแรกคือ response ตัวที่สองคือ out ตัวที่สามคือชื่อของไฟล์ excel และตัวสุดท้ายคือข้อมูลที่จะเขียนลงในไฟล์ excel
ExcelFreedom excelFreedom = new ExcelFreedom(response, out, "excel", table.toString());

excelFreedom.write(); // สั่งให้เขียนไฟล์

ผลลัพธ์ที่ได้คือ

เพิ่ม sheet
เพิ่ม tag <table></table> ขึ้นมาใหม่ก็จะได้ sheet ใหม่ขึ้นมา จำนวน sheet ขึ้นอยู่กับ tag <table>
ตัวอย่างในที่นี้เราจะสร้าง 2 sheet

StringBuilder table = new StringBuilder();
table.append("<table>");
  table.append("<tr>");
    table.append("<td>A</td>");
    table.append("<td>B</td>");
    table.append("<td>C</td>");
  table.append("</tr>");
table.append("</table>");
table.append("<table>");
  table.append("<tr>");
    table.append("<td>D</td>");
    table.append("<td>E</td>");
    table.append("<td>F</td>");
  table.append("</tr>");
table.append("</table>");

ผลลัพธ์ที่ได้คือ

เปลี่ยนชื่อ sheet
ใช้ tag <sheet>ชื่อ sheet</sheet> โดยใส่ไว้ต่อจาก <table>
```
table.append("<table>");
table.append("<sheet>new sheet</sheet>");
```
ผลลัพธ์ที่ได้คือ
ผสานเซลล์ แนวนอน
ใช้ tag <colspan>ตัวเลขที่ต้องการ</colspan>
```
table.append("<td><colspan>2</colspan>colspan 2</td>");
table.append("<td><colspan>3</colspan>colspan 3</td>");
```
ผลลัพธ์ที่ได้คือ
ผสานเซลล์ แนวตั้ง
ใช้ tag <rowspan>ตัวเลขที่ต้องการ</rowspan>
```
table.append("<td><rowspan>2</rowspan>rowspan 2</td>");
table.append("<td><rowspan>3</rowspan>rowspan 3</td>");
```
ผลลัพธ์ที่ได้คือ
ขยายขนาดความกว้างของคอลัมน์
ใช้ tag <width>ตัวเลขที่ต้องการ</width>
```
table.append("<td><width>10</width>width 10</td>");
table.append("<td><width>20</width>width 20</td>");
```
ผลลัพธ์ที่ได้คือ

ขยายขนาดความสูงของคอลัมน์
ใช้ tag <height>ตัวเลขที่ต้องการ</height>

table.append("<tr>");
    table.append("<td><height>500</height>height 500</td>");
table.append("</tr>");
table.append("<tr>");
    table.append("<td><height>600</height>height 600</td>");
table.append("</tr>");

ผลลัพธ์ที่ได้คือ

การจัดรูปแบบ
ใช้ tag <format>รูปแบบตาม list ข้างล่าง</format> ค่าเริ่มต้นคือ border-center
- left
- center
- right
- left-middle
- center-middle
- right-middle
- left-top
- center-top
- right-top
- orientation
- orientation-middle
- orientation-top
```
table.append("<td><format>left</format>left</td>");
table.append("<td><format>center</format>center</td>");
table.append("<td><format>right</format>right</td>");
table.append("<td><format>left-middle</format>left-middle</td>");
table.append("<td><format>center-middle</format>center-middle</td>");
table.append("<td><format>right-middle</format>right-middle</td>");
table.append("<td><format>left-top</format>left-top</td>");
table.append("<td><format>center-top</format>center-top</td>");
table.append("<td><format>right-top</format>right-top</td>");
table.append("<td><format>orientation</format>orientation</td>");
table.append("<td><format>orientation-middle</format>orientation-middle</td>");
table.append("<td><format>orientation-top</format>orientation-top</td>");
```
ผลลัพธ์ที่ได้คือ

ใส่กรอบให้กับคอลัมน์ทั้งหมด ใช้ border
- border-left
- border-center
- border-right
- border-left-middle
- border-center-middle
- border-right-middle
- border-left-top
- border-center-top
- border-right-top
- border-orientation
- border-orientation-middle
- border-orientation-top
ผลลัพธ์ที่ได้คือ

ใส่กรอบให้กับคอลัมน์บนและล่าง ใช้ border-tb
- border-tb-left
- border-tb-center
- border-tb-right
- border-tb-left-middle
- border-tb-center-middle
- border-tb-right-middle
- border-tb-left-top
- border-tb-center-top
- border-tb-right-top
- border-tb-orientation
- border-tb-orientation-middle
- border-tb-orientation-top
ผลลัพธ์ที่ได้คือ

ใส่กรอบให้กับคอลัมน์บนและล่างแบบ 2 เส้น ใช้ border-tb-double
- border-tb-double-left
- border-tb-double-center
- border-tb-double-right
- border-tb-double-left-middle
- border-tb-double-center-middle
- border-tb-double-right-middle
- border-tb-double-left-top
- border-tb-double-center-top
- border-tb-double-right-top
- border-tb-double-orientation
- border-tb-double-orientation-middle
- border-tb-double-orientation-top
ผลลัพธ์ที่ได้คือ

ใส่กรอบให้กับคอลัมน์บน 1 เส้น และ ล่างแบบ 2 เส้น ใช้ border-tb-single-double
- border-tb-single-double-left
- border-tb-single-double-center
- border-tb-single-double-right
- border-tb-single-double-left-middle
- border-tb-single-double-center-middle
- border-tb-single-double-right-middle
- border-tb-single-double-left-top
- border-tb-single-double-center-top
- border-tb-single-double-right-top
- border-tb-single-double-orientation
- border-tb-single-double-orientation-middle
- border-tb-single-double-orientation-top
ผลลัพธ์ที่ได้คือ

ใส่กรอบให้กับคอลัมน์เฉพาะล่างแบบ 2 เส้น ใช้ border-b-double
- border-b-double-left
- border-b-double-center
- border-b-double-right
- border-b-double-left-middle
- border-b-double-center-middle
- border-b-double-right-middle
- border-b-double-left-top
- border-b-double-center-top
- border-b-double-right-top
- border-b-double-orientation
- border-b-double-orientation-middle
- border-b-double-orientation-top
ผลลัพธ์ที่ได้คือ

ใส่กรอบให้กับคอลัมน์ทั้งหมดเฉพาะล่างแบบ 2 เส้น ใช้ border-all-b-double
- border-all-b-double-left
- border-all-b-double-center
- border-all-b-double-right
- border-all-b-double-left-middle
- border-all-b-double-center-middle
- border-all-b-double-right-middle
- border-all-b-double-left-top
- border-all-b-double-center-top
- border-all-b-double-right-top
- border-all-b-double-orientation
- border-all-b-double-orientation-middle
- border-all-b-double-orientation-top
ผลลัพธ์ที่ได้คือ

ถ้าต้องการให้กรอบเป็นเส้นปะให้ใช้ dashed โดยเอามาวางต่อจาก border
ตัวอย่างเช่น border-dashed-center

ผลลัพธ์ที่ได้คือ

เปลี่ยน font
ใช้ tag <font-name>รูปแบบตาม list ข้างล่าง</font-name> ค่าเริ่มต้นคือ arial

arial
tahoma
courier
times
thsarabun_spk
thsarabun_new

table.append("<td><font-name>arial</font-name>arial</td>");
table.append("<td><font-name>tahoma</font-name>tahoma</td>");
table.append("<td><font-name>courier</font-name>courier</td>");
table.append("<td><font-name>times</font-name>times</td>");
table.append("<td><font-name>thsarabun_spk</font-name>thsarabun_spk</td>");
table.append("<td><font-name>thsarabun_new</font-name>thsarabun_new</td>");

ผลลัพธ์ที่ได้คือ

เปลี่ยนขนาด font
ใช้ tag <font-size>ขนาด</font-size> ค่าเริ่มต้นคือ 10
```
table.append("<td><font-size>10</font-size>font default</td>");
table.append("<td><font-size>20</font-size>font size 20</td>");
```
ผลลัพธ์ที่ได้คือ
ตัวอักษรตัวหนา
ใช้ tag <b>true or false</b> ค่าเริ่มต้นคือ false
```
table.append("<td>font normal</td>");
table.append("<td><b>true</b>font bold</td>");
```
ผลลัพธ์ที่ได้คือ
ตัวอักษรตัวเอียง
ใช้ tag <i>true or false</i> ค่าเริ่มต้นคือ false
```
table.append("<td>font normal</td>");
table.append("<td><i>true</i>font italic</td>");
```
ผลลัพธ์ที่ได้คือ
ขีดเส้นใต้
ใช้ tag <u>รูปแบบตาม list ข้างล่าง</u> ค่าเริ่มต้นคือ no_underline
- no_underline
- single
- single_accounting
- double
- double_accounting
```
table.append("<td>no underline</td>");
table.append("<td><u>single</u>single</td>");
table.append("<td><u>single_accounting</u>single accounting</td>");
table.append("<td><u>double</u>double</td>");
table.append("<td><u>double_accounting</u>double accounting</td>");
```
ผลลัพธ์ที่ได้คือ
เปลี่ยนประเภทของคอลัมน์
ใช้ tag <type>รูปแบบตาม list ข้างล่าง</type> ค่าเริ่มต้นคือ string
- string
- number
- number-money
- number-money-float-one
- number-money-float-two
```
table.append("<td>default string</td>");
table.append("<td><type>number</type>7777</td>");
table.append("<td><type>number-money</type>7777</td>");
table.append("<td><type>number-money-float-one</type>7777</td>");
table.append("<td><type>number-money-float-two</type>7777</td>");
```
ผลลัพธ์ที่ได้คือ
สี
ใช้ tag <background-color>สีตาม list ข้างล่าง</background-color> เมื่อต้องการเปลี่ยนสีพื้นหลัง ค่าเริ่มต้นคือ ไม่มีสี
ใช้ tag <font-color>สีตาม list ข้างล่าง</font-color> เมื่อต้องการเปลี่ยนสีตัวอักษร ค่าเริ่มต้นคือ black
- aqua
- black
- blue
- blue_grey
- bright_green
- brown
- coral
- dark_blue
- dark_green
- dark_purple
- dark_red
- dark_teal
- dark_yellow
- gold
- gray_25
- gray_50
- gray_80
- grey_25_percent
- grey_40_percent
- grey_50_percent
- grey_80_percent
- green
- ice_blue
- indigo
- ivory
- lavender
- light_blue
- light_green
- light_orange
- light_turquoise
- lime
- ocean_blue
- ocean_green
- orange
- pale_blue
- periwinkle
- pink
- plum
- red
- rose
- sea_green
- sky_blue
- tan
- teal
- turquoise
- very_light_yellow
- violet
- white
- yellow
เปลี่ยนสีพื้นหลังคอลัมน์
```
table.append("<td><background-color>orange</background-color>orange</td>");
table.append("<td><background-color>green</background-color>green</td>");
```
ผลลัพธ์ที่ได้คือ

เปลี่ยนสีตัวอักษร
```
table.append("<td><font-color>orange</font-color>orange</td>");
table.append("<td><font-color>green</font-color>green</td>");
```
ผลลัพธ์ที่ได้คือ

สูตรการคำนวณ ต้องเป็นตัวเลขเท่านั้น
ใช้ tag <formula>true or false</formula> ค่าเริ่มต้นคือ false

// รวมค่าของ 20 40 60
table.append("<td><type>number</type>20</td>");
table.append("<td><type>number</type>40</td>");
table.append("<td><type>number</type>60</td>");
table.append("<td><type>number</type><formula>true</formula>SUM(A1:C1)</td>");

ผลลัพธ์ที่ได้คือ

กรณีใช้สูตรแล้วไม่รู้ว่าเราจะใช้คอลัมน์ ไหน ถึงไหน ให้ใช้ tag <formula-no>true or false</formula-no> ค่าเริ่มต้นคือ false
รูปแบบจะเป็น SUM(#column@row#:#column@row#)
ตัวอย่าง

#1@1# จะมีค่าเท่ากับ A1
#2@1# จะมีค่าเท่ากับ B1
#3@1# จะมีค่าเท่ากับ C1
#1@2# จะมีค่าเท่ากับ A2
#2@2# จะมีค่าเท่ากับ B2
#3@2# จะมีค่าเท่ากับ C2
#1@3# จะมีค่าเท่ากับ A3
#2@3# จะมีค่าเท่ากับ B3
#3@3# จะมีค่าเท่ากับ C3

// รวมค่าของ 20 40 60
table.append("<td><type>number</type>20</td>");
table.append("<td><type>number</type>40</td>");
table.append("<td><type>number</type>60</td>");
table.append("<td><type>number</type><formula-no>true</formula-no>SUM(#1@1#:#3@1#)</td>");

ผลลัพธ์ที่ได้คือ

เพิ่มรูปภาพ
ใช้ tag <img>ที่อยู่ของรูปภาพ</img>
```
table.append("<td><img>D://image.jpg</img></td>");
```
ผลลัพธ์ที่ได้คือ

ปรับขนาดความกว้างความสูง
ใช้ tag <img-width>ขนาดความกว้าง</img-width>
ใช้ tag <img-height>ขนาดความสูง</img-height>
ตัวอย่างเช่น กำหนดความกว้างเท่ากับ 4 และความสูงเท่ากับ 5
```
table.append("<td><img>D://image.jpg</img><img-width>4</img-width><img-height>5</img-height></td>");
```
ผลลัพธ์ที่ได้คือ
กำหนดค่าเริ่มต้น
```
ExcelFreedom excelFreedom = new ExcelFreedom("D://", "excel", table.toString());
// เรียกใช้ก่อน method write()
excelFreedom.write();
```
- กำหนดความสูงของคอลัมน์ setDefaultHeight(ความสูง); ตัวอย่าง excelFreedom.setDefaultHeight(700);
- กำหนดสีตัวอักษร setDefaultHeight(สี); ตัวอย่าง excelFreedom.setDefaultFontColor("red");
- กำหนดฟ้อนต์ setDefaultFontName(ฟ้อนต์); ตัวอย่าง excelFreedom.setDefaultFontName("tahoma");
- กำหนดขนาดตัวอักษร setDefaultFontSize(ขนาด) ตัวอย่าง excelFreedom.setDefaultFontSize(20);
- กำหนดรูปแบบ setDefaultFormat(รูปแบบ); ตัวอย่าง excelFreedom.setDefaultFormat("border-left");
การ deploy
- create your JIRA account https://issues.sonatype.org/secure/Signup!default.jspa
- tutorial https://central.sonatype.org/pages/ossrh-guide.html#ossrh-usage-notes
- tutorial https://www.youtube.com/watch?v=bxP9IuJbcDQ
- tutorial https://www.youtube.com/watch?v=dXR4pJ_zS-0&feature=youtu.be
- tutorial https://www.youtube.com/watch?v=0gyF17kWMLg&feature=youtu.be
- download https://www.gnupg.org/download/index.html
- create file settings.xml in location C:\Users{user}.m2
- เอาค่ามาจาก User token dashboard https://oss.sonatype.org/#profile;User%20Token
```
  <settings>
    <servers>
        <server>
            <id>ossrh</id>
            <username>fqu9Yd1D4</username>
            <password>bKCkw8a+Jv0IRawQxr3x0zXffwkSEQxu7WPKGezDIhJWb</password>
        </server>
    </servers>
  </settings>
```
- command maven ต้องไปใส่ใน pom 1.0.0-SNAPSHOT ก่อนด้วย
- gpg --keyserver hkp://keyserver.ubuntu.com --send-keys 1CAF7CE77B8068D2 key คือ ค่าที่ได้จากโปรแกรม Kleopatra
- mvn clean deploy
- mvn versions:set -DnewVersion=1.0.0
- mvn clean deploy -P release

Versions

Version
1.0.0 May 15, 2018

excelfreedom

License

GroupId

ArtifactId

Last Version

Release Date

Type

Description

Project URL

Source Code Management

Download excelfreedom

How to add to project

Dependencies

compile (4)

Project Modules

Tutorial ExcelFreedom

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

ผลลัพธ์ที่ได้คือ

Versions