excelfreedom

freedom utilities

Лицензия

Лицензия

Группа

Группа

com.github.nut077
Идентификатор

Идентификатор

excelfreedom
Последняя версия

Последняя версия

1.0.0
Дата

Дата

Тип

Тип

jar
Описание

Описание

excelfreedom
freedom utilities
Ссылка на сайт

Ссылка на сайт

https://github.com/nut077/excelfreedom/
Система контроля версий

Система контроля версий

https://github.com/nut077/excelfreedom

Скачать excelfreedom

Как подключить последнюю версию

<!-- https://jarcasting.com/artifacts/com.github.nut077/excelfreedom/ -->
<dependency>
    <groupId>com.github.nut077</groupId>
    <artifactId>excelfreedom</artifactId>
    <version>1.0.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.nut077/excelfreedom/
implementation 'com.github.nut077:excelfreedom:1.0.0'
// https://jarcasting.com/artifacts/com.github.nut077/excelfreedom/
implementation ("com.github.nut077:excelfreedom:1.0.0")
'com.github.nut077:excelfreedom:jar:1.0.0'
<dependency org="com.github.nut077" name="excelfreedom" rev="1.0.0">
  <artifact name="excelfreedom" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.nut077', module='excelfreedom', version='1.0.0')
)
libraryDependencies += "com.github.nut077" % "excelfreedom" % "1.0.0"
[com.github.nut077/excelfreedom "1.0.0"]

Зависимости

compile (4)

Идентификатор библиотеки Тип Версия
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

Модули Проекта

Данный проект не имеет модулей.

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(); // สั่งให้เขียนไฟล์ 
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • เพิ่ม 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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • เปลี่ยนชื่อ sheet
    ใช้ tag <sheet>ชื่อ sheet</sheet> โดยใส่ไว้ต่อจาก <table>

    table.append("<table>");
    table.append("<sheet>new sheet</sheet>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • ผสานเซลล์ แนวนอน
    ใช้ tag <colspan>ตัวเลขที่ต้องการ</colspan>

    table.append("<td><colspan>2</colspan>colspan 2</td>");
    table.append("<td><colspan>3</colspan>colspan 3</td>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • ผสานเซลล์ แนวตั้ง
    ใช้ tag <rowspan>ตัวเลขที่ต้องการ</rowspan>

    table.append("<td><rowspan>2</rowspan>rowspan 2</td>");
    table.append("<td><rowspan>3</rowspan>rowspan 3</td>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

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

    table.append("<td><width>10</width>width 10</td>");
    table.append("<td><width>20</width>width 20</td>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • ขยายขนาดความสูงของคอลัมน์
    ใช้ 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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • การจัดรูปแบบ
    ใช้ 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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

    ใส่กรอบให้กับคอลัมน์ทั้งหมด ใช้ 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
    ผลลัพธ์ที่ได้คือ

    Capture.png

    ใส่กรอบให้กับคอลัมน์บนและล่าง ใช้ 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
    ผลลัพธ์ที่ได้คือ

    Capture.png

    ใส่กรอบให้กับคอลัมน์บนและล่างแบบ 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
    ผลลัพธ์ที่ได้คือ

    Capture.png

    ใส่กรอบให้กับคอลัมน์บน 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
    ผลลัพธ์ที่ได้คือ

    Capture.png

    ใส่กรอบให้กับคอลัมน์เฉพาะล่างแบบ 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
    ผลลัพธ์ที่ได้คือ

    Capture.png

    ใส่กรอบให้กับคอลัมน์ทั้งหมดเฉพาะล่างแบบ 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
    ผลลัพธ์ที่ได้คือ

    Capture.png

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

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

    Capture.png

  • เปลี่ยน 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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • เปลี่ยนขนาด 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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • ตัวอักษรตัวหนา
    ใช้ tag <b>true or false</b> ค่าเริ่มต้นคือ false

    table.append("<td>font normal</td>");
    table.append("<td><b>true</b>font bold</td>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • ตัวอักษรตัวเอียง
    ใช้ tag <i>true or false</i> ค่าเริ่มต้นคือ false

    table.append("<td>font normal</td>");
    table.append("<td><i>true</i>font italic</td>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • ขีดเส้นใต้
    ใช้ 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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • เปลี่ยนประเภทของคอลัมน์
    ใช้ 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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • สี
    ใช้ 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 Capture.png

    เปลี่ยนสีพื้นหลังคอลัมน์

    table.append("<td><background-color>orange</background-color>orange</td>");
    table.append("<td><background-color>green</background-color>green</td>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

    เปลี่ยนสีตัวอักษร

    table.append("<td><font-color>orange</font-color>orange</td>");
    table.append("<td><font-color>green</font-color>green</td>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • สูตรการคำนวณ ต้องเป็นตัวเลขเท่านั้น
    ใช้ 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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

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

    #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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • เพิ่มรูปภาพ
    ใช้ tag <img>ที่อยู่ของรูปภาพ</img>

    table.append("<td><img>D://image.jpg</img></td>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

    ปรับขนาดความกว้างความสูง
    ใช้ 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>");
    ผลลัพธ์ที่ได้คือ

    Capture.png

  • กำหนดค่าเริ่มต้น

    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

      <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

Версии библиотеки

Версия
1.0.0