--------------------------------------
``@XlsOrder``
--------------------------------------

書き込み時に、``@XlsHoriontalRecords`` を使用して行の挿入や削除する設定している場合、フィールドの処理順序によって、``Map<String, Point> positions`` フィールドで座標が、ずれる場合があります。

このようなときに、``@XlsOrder`` の属性 ``value`` で書き込む処理順序を指定し一定に保つことができます。
属性 value はJavaの仕様により省略が可能です。

``@XlsOrder`` を付与しないフィールドは、付与しているフィールドよりも後から処理が実行されます。
属性valueが同じ値を設定されているときは、 フィールド名の昇順で優先度を決めて処理されます。


.. figure:: ./_static/Hint.png
   :align: center
   
   Order

.. sourcecode:: java
    :linenos:
    
    @XlsSheet(name="Users")
    public class SampleSheet {
        
        // セルの位置情報
        private Map<String, Point> positions;
        
        @XlsOrder(order=1)
        @XlsHorizontalRecords(tableLabel="ユーザ一覧", terminal=RecordTerminal.Border)
        @XlsRecordOption(overOperation=OverOperation.Insert, remainedOperation=RemainedOperation.Delete)
        private List<UserRecord> records;
        
        // 属性valueは省略が可能
        @XlsOrder(2)
        @XlsLabelledCell(label="更新日", type=LabelledCellType.Right)
        private Date updateTime;
        
    }


.. note::
    
    ソースコード上で定義したフィールドやメソッドの記述順は、実行時には保証されないため、``@XlsOrder`` で順番を指定し、処理順序を一定にできます。
    
    ``@XlsOrder`` を付与すると、書き込み時だけでなく読み込み時にも処理順序が一定になります。