UtilOffice (greetgo.msoffice 0.4.24 API)

java.lang.Object
- kz.greetgo.msoffice.UtilOffice

public class UtilOffice
extends java.lang.Object

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`MILLIS_IN_DAY` Количество миллисекунд в сутках
`static java.text.SimpleDateFormat`	`W3CDTF` Стандартное представление даты и времени по w3c

Constructor Summary

Constructors
Constructor and Description

UtilOffice()

Constructors
Constructor and Description
`UtilOffice()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`appendLettersNumber(java.lang.StringBuilder sb, int n)`
`static void`	`appendToSB(java.io.InputStream in, java.lang.StringBuilder sb)`
`static void`	`appendToSB0(java.io.InputStream in, java.lang.StringBuilder sb)`
`static int`	`charAsHex(char c)` Получает величину 16-чного символа
`static boolean`	`cleanDir(java.lang.String dir)` Очищает папку - удаляет все её файлы и подпапки
`static java.io.InputStream`	`copy(java.io.InputStream in)` Формирует копию InputStream
`static void`	`copyStreams(java.io.InputStream in, java.io.OutputStream out)` Копирует данные из входного потока в выходной через буфер размером 2048 байт
`static void`	`copyStreams(java.io.InputStream in, java.io.OutputStream out, int bufferSize)`
`static java.util.Calendar`	`epochStart()`
`static java.util.Date`	`excelToDate(java.lang.String excelValue)` Преобразует excel-евское представление даты-времени в java-представление (java.util.Date)
`static java.lang.String`	`extractBaseName(java.lang.String fullName)` Вырезает из полного пути с именем файла только его имя.
`static java.lang.String`	`killFirstSlash(java.lang.String s)` Удаляет слэш из начала строки, если он там есть, иначе ни чего не делает
`static int[]`	`parseCellCoord(java.lang.String coord)` Парсит представление координат ячейки.
`static int`	`parseLettersNumber(java.lang.String s)` Парсит буквенное число, преобразуя его в обычное: A->0, B->1, C->2, ..., Z->25, AA->26, AB->27, ..., ZZ->701, AAA->702, ...
`static int`	`parsePartAsHex(java.lang.String hex, int index, int count)` Парсит строку как целое представленое в 16-чных цыфрах
`static java.util.Date`	`parseW3CDTF(java.lang.String str)` Преобразует строку формата W3CDTF в дату
`static boolean`	`removeDir(java.lang.String dir)` Удаляет папку вместе со всем её содержимым
`static java.lang.String`	`streamToStr(java.io.InputStream in)` Принимает поток как текстовый в кодировке UTF-8, и представляет его как строку
`static java.lang.String`	`streamToStr0(java.io.InputStream in)`
`static java.lang.String`	`toExcelDateTime(java.util.Date date)` Пребразует java-представление даты-времени в excel-евское
`static java.lang.String`	`toHEX(java.awt.Color color)` Представляет цвет в виде шеснадцатиричной строки
`static java.lang.String`	`toLenZero(int len, java.lang.String s)` Увеличивает длину строки до указанной добавлением нуля в начало строки
`static java.lang.String`	`toLettersNumber(int n)` Формирует "буквенное" число: 0->A, 1->B, ..., 25->Z, 26->AA, 27->AB, ....
`static java.lang.String`	`toTablePosition(int row, int col)` Преобразует координаты ячейки таблицы в электронно-табличную форму
`static java.lang.String`	`toW3CDTF(java.util.Date date)` Преобразует дату в формат W3CDTF
`static void`	`zipDir(java.lang.String dir, java.io.OutputStream out)` Зиппует указанную папку со всем её содержимым рекурсивно и отправляет в указанный поток
`static void`	`zipDirEx(java.lang.String dir, java.io.OutputStream out)` Зиппует указанную папку со всем её содержимым рекурсивно и отправляет в указанный поток

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - W3CDTF
```
public static final java.text.SimpleDateFormat W3CDTF
```
    Стандартное представление даты и времени по w3c
  - MILLIS_IN_DAY
```
public static final int MILLIS_IN_DAY
```
    Количество миллисекунд в сутках
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - UtilOffice
```
public UtilOffice()
```
- Method Detail
  - toW3CDTF
```
public static java.lang.String toW3CDTF(java.util.Date date)
```
    Преобразует дату в формат W3CDTF
    
    Parameters:
    
    date - исходная дата
    
    Returns:
    
    строка даты в формате W3CDTF, или пустая строка если на вход пришел null
  - parseW3CDTF
```
public static java.util.Date parseW3CDTF(java.lang.String str)
```
    Преобразует строку формата W3CDTF в дату
    
    Parameters:
    
    str - строка содержащая дату в формате W3CDTF
    
    Returns:
    
    дата или null, если str == null
  - toLenZero
```
public static java.lang.String toLenZero(int len,
                                         java.lang.String s)
```
    Увеличивает длину строки до указанной добавлением нуля в начало строки
    
    Parameters:
    
    len - требуемая длина строки
    
    s - исходная строка
    
    Returns:
    
    результирующая строка
  - toHEX
```
public static java.lang.String toHEX(java.awt.Color color)
```
    Представляет цвет в виде шеснадцатиричной строки
    
    Parameters:
    
    color - исходный цвет
    
    Returns:
    
    шеснадцатиричное представление цвета
  - appendToSB
```
public static void appendToSB(java.io.InputStream in,
                              java.lang.StringBuilder sb)
```
  - appendToSB0
```
public static void appendToSB0(java.io.InputStream in,
                               java.lang.StringBuilder sb)
                        throws java.lang.Exception
```
    Throws:
    
    java.lang.Exception
  - streamToStr
```
public static java.lang.String streamToStr(java.io.InputStream in)
```
    Принимает поток как текстовый в кодировке UTF-8, и представляет его как строку
    
    Parameters:
    
    in - принимаемый поток. Будет считан до конца и закрыт.
    
    Returns:
    
    полученная строка
  - streamToStr0
```
public static java.lang.String streamToStr0(java.io.InputStream in)
                                     throws java.lang.Exception
```
    Throws:
    
    java.lang.Exception
  - copyStreams
```
public static void copyStreams(java.io.InputStream in,
                               java.io.OutputStream out,
                               int bufferSize)
                        throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - copyStreams
```
public static void copyStreams(java.io.InputStream in,
                               java.io.OutputStream out)
                        throws java.io.IOException
```
    Копирует данные из входного потока в выходной через буфер размером 2048 байт
    
    Parameters:
    
    in - входной поток
    
    out - выходной поток
    
    Throws:
    
    java.io.IOException - происходт в случае ошибки ввода/вывода
  - killFirstSlash
```
public static java.lang.String killFirstSlash(java.lang.String s)
```
    Удаляет слэш из начала строки, если он там есть, иначе ни чего не делает
    
    Parameters:
    
    s - исходная строка
    
    Returns:
    
    результирующая строка
  - extractBaseName
```
public static java.lang.String extractBaseName(java.lang.String fullName)
```
    Вырезает из полного пути с именем файла только его имя. Если в конце слэш, то он игнорируется
    
    Например:
    asd/asd/wow.xml -> wow.xml /wow/asd/dsa/uu/mama/ -> mama
    
    Parameters:
    
    fullName - полный путь к файлу или папке
    
    Returns:
    
    только имя файла или папки
  - removeDir
```
public static boolean removeDir(java.lang.String dir)
```
    Удаляет папку вместе со всем её содержимым
    
    Parameters:
    
    dir - путь к удаляемой папке (абсолютный или относительный)
    
    Returns:
    
    признак произведения операции: если файловая система не изменилась, то возвращается лож; если же хоть что-то удалилось, то возвращается истина
  - cleanDir
```
public static boolean cleanDir(java.lang.String dir)
```
    Очищает папку - удаляет все её файлы и подпапки
    
    Parameters:
    
    dir - путь к очищаемой папке (абсолютный или относительный)
    
    Returns:
    
    признак произведения операции: если файловая система не изменилась, то возвращается лож; если же хоть что-то удалилось, то возвращается истина
  - toLettersNumber
```
public static java.lang.String toLettersNumber(int n)
```
    Формирует "буквенное" число: 0->A, 1->B, ..., 25->Z, 26->AA, 27->AB, .... (Такие числа используются для обозначения колонок в электронных таблицах)
    
    Parameters:
    
    n - исходное число (должно быть больше или равно нулю)
    
    Returns:
    
    результирующее "буквенное" число
  - appendLettersNumber
```
public static void appendLettersNumber(java.lang.StringBuilder sb,
                                       int n)
```
  - parseLettersNumber
```
public static int parseLettersNumber(java.lang.String s)
```
    Парсит буквенное число, преобразуя его в обычное: A->0, B->1, C->2, ..., Z->25, AA->26, AB->27, ..., ZZ->701, AAA->702, ... (Такие числа используются для обозначения колонок в электронных таблицах)
    
    Parameters:
    
    s - "буквенное" число
    
    Returns:
    
    Распарсеное число
  - parseCellCoord
```
public static int[] parseCellCoord(java.lang.String coord)
```
    Парсит представление координат ячейки.
    
    Parameters:
    
    coord - Строка с координатой: символьное обозначение столбца и номер строки ("B6", "C8", "AB12").
    
    Returns:
    
    [ col, row ], нумерация с 1
  - copy
```
public static java.io.InputStream copy(java.io.InputStream in)
```
    Формирует копию InputStream
    
    Необходим например для предотвращения закрытия оригинального потока, при закрытии копии
    
    Parameters:
    
    in - оригинальный поток
    
    Returns:
    
    копия
  - epochStart
```
public static final java.util.Calendar epochStart()
```
  - excelToDate
```
public static java.util.Date excelToDate(java.lang.String excelValue)
```
    Преобразует excel-евское представление даты-времени в java-представление (java.util.Date)
    
    Parameters:
    
    excelValue - excel-евское представление даты-времени
    
    Returns:
    
    java-представление даты-времени
  - toExcelDateTime
```
public static java.lang.String toExcelDateTime(java.util.Date date)
```
    Пребразует java-представление даты-времени в excel-евское
    
    Parameters:
    
    date - java-представление даты-времени
    
    Returns:
    
    excel-евское представление даты-времени в виде строки
  - charAsHex
```
public static int charAsHex(char c)
```
    Получает величину 16-чного символа
    
    (0->0, 1->1, ..., 9->9, A->10, B->11, ..., F->15)
    
    Parameters:
    
    c - 16-чный символ
    
    Returns:
    
    его величина
  - parsePartAsHex
```
public static int parsePartAsHex(java.lang.String hex,
                                 int index,
                                 int count)
```
    Парсит строку как целое представленое в 16-чных цыфрах
    
    Parameters:
    
    hex - входная строка
    
    index - индекс первого читаемого символа
    
    count - количество читаемых символов
    
    Returns:
    
    полученое целое
  - toTablePosition
```
public static java.lang.String toTablePosition(int row,
                                               int col)
```
    Преобразует координаты ячейки таблицы в электронно-табличную форму
    
    Например для
    (row,col) = (1,0) -> "A1"
    (row,col) = (4,1) -> "A4"
    (row,col) = (4,2) -> "B4"
    (row,col) = (7,3) -> "C7"
    (row,col) = (7,10) -> "J7"
    
    Parameters:
    
    row - индекс строки (1 - первая строка, 2 - вторая, ...)
    
    col - индекс колонки (0 - первая колонка, 1 - вторая, ...)
    
    Returns:
    
    электронно-табличная форма координат
  - zipDir
```
public static void zipDir(java.lang.String dir,
                          java.io.OutputStream out)
```
    Зиппует указанную папку со всем её содержимым рекурсивно и отправляет в указанный поток
    
    Parameters:
    
    dir - зиппуемая папка
    
    out - выводимый поток
  - zipDirEx
```
public static void zipDirEx(java.lang.String dir,
                            java.io.OutputStream out)
                     throws java.lang.Exception
```
    Зиппует указанную папку со всем её содержимым рекурсивно и отправляет в указанный поток
    
    Parameters:
    
    dir - зиппуемая папка
    
    out - выводимый поток
    
    Throws:
    
    java.lang.Exception - утобы не делать try/catch-блок

Class UtilOffice

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

W3CDTF

MILLIS_IN_DAY

Constructor Detail

UtilOffice

Method Detail

toW3CDTF

parseW3CDTF

toLenZero

toHEX

appendToSB

appendToSB0

streamToStr

streamToStr0

copyStreams

copyStreams

killFirstSlash

extractBaseName

removeDir

cleanDir

toLettersNumber

appendLettersNumber

parseLettersNumber

parseCellCoord

copy

epochStart

excelToDate

toExcelDateTime

charAsHex

parsePartAsHex

toTablePosition

zipDir

zipDirEx