本文整理了Java中com.thomsonreuters.upa.codec.Vector类的一些代码示例，展示了Vector类的具体用法。这些代码示例主要来源于Github/Stackoverflow/Maven等平台，是从一些精选项目中提取出来的代码，具有较强的参考意义，能在一定程度帮忙到你。Vector类的具体详情如下：
包路径：com.thomsonreuters.upa.codec.Vector
类名称：Vector

Vector介绍

[英]The Vector is a uniform container type of index-value pair entries. Each entry, known as a VectorEntry, contains an index, correlating to the entry's position in the information stream and value. A Vector can contain zero to N entries (zero entries indicates an empty Vector).

Vector Encoding Example

The following sample demonstrates how to encode a Vector containing Series values. The example encodes three VectorEntry values as well as summary data:

The first entry is encoded from an unencoded series
The second entry is encoded from a buffer containing a pre-encoded series and has perm data
The third is a clear action type with no payload.
This example demonstrates error handling for the initial encode method. To simplify the example, additional error handling is omitted (though it should be performed).

// populate vector structure prior to call to vector.encodeInit() 
// indicate that summary data and a total count hint will be encoded 
vector.flags(VectorFlags.HAS_SUMMRAY_DATA | VectorFlags.HAS_TOTAL_COUNT | VectorFlags.HAS_PER_ENTRY_PERM_DATA); 
// populate containerType and total count hint 
vector.containerType(DataTypes.SERIES); 
vector.totalCountHint(3); 
// begin encoding of vector - assumes that encIter is already populated with 
// buffer and version information, store return value to determine success or 
// failure 
if ((retVal = vector.encodeInit(encIter, 50, 0)) < CodecReturnCodes.SUCCESS) 
{ 
// error condition - switch our success value to false so we can roll back 
success = false; 
} 
else 
{ 
// vector init encoding was successful 
// create a single VectorEntry and Series and reuse for each entry 
VectorEntry vectorEntry = CodecFactory.createVectorEntry(); 
Series series = CodecFactory.createSeries(); 
// encode expected summary data, init for this was done by 
// vector.encodeInit - this type should match vector.containerType 
{ 
// now encode nested container using its own specific encode methods 
// begin encoding of series - using same encIterator as vector 
retVal = series.encodeInit(encIter, 0, 0); 
{ 
// ----- Continue encoding series entries, see Series encoding 
// example ----- 
// Complete nested container encoding 
retVal = series.encodeComplete(encIter, success); 
} 
// complete encoding of summary data. If any series entry encoding 
// failed, success is false 
retVal = vector.encodeSummaryComplete(encIter, success); 
// FIRST Vector Entry: encode entry from unencoded data. Approx. encoded 
// length 90 bytes 
//populate index and action, no perm data on this entry 
vectorEntry.index(1); 
vectorEntry.flags(VectorEntryFlags.NONE); 
vectorEntry.action(VectorEntryActions.UPDATE); 
retVal = vectorEntry.encodeInit(encIter, 90); 
//encode contained series - this type should match vector.containerType 
{ 
//now encode nested container using its own specific encode methods 
//clear, then begin encoding of series - using same encIterator as vector 
series.clear(); 
retVal = series.encodeInit(encIter, 0, 0); 
//-----Continue encoding series entries. See example in Series --- 
retVal = series.encodeComplete(encIter, success);     
} 
//SECOND Vector Entry: encode entry from pre-encoded buffer containing an encoded Series 
//assuming pEncSeries Buffer contains the pre-encoded payload with data and length populated 
//and pPermData contains permission data information 
vectorEntry.index(2); 
//by passing permData on an entry, the map encoding functionality will implicitly set the 
//Vector.HAS_PER_ENTRY_PERM flag 
vectorEntry.flags(VectorEntryFlags.HAS_PERM_DATA); 
vectorEntry.action(VectorEntryActions.SET); 
vectorEntry.permData(permData); 
vectorEntry.encodedData(encSeries); 
retVal = vectorEntry.encode(encIter); 
//THIRD Vector Entry: encode entry with clear action, no payload on clear 
//Should clear entry for safety, this will set flags to NONE  
vectorEntry.clear(); 
vectorEntry.index(3); 
vectorEntry.action(VectorEntryFlags.CLEAR); 
retVal = vectorEntry.encode(encIter); 
} 
//complete vector encoding.  If success parameter is true, this will finalize encoding. 
//If success parameter is false, this will roll back encoding prior to vector.encodeInit(); 
retVal = vector.encodeComplete(encIter, success);

Vector decoding example

The following sample illustrates how to decode a Vector and is structured to decode each entry to the contained value. This sample code assumes the housed container type is a Series. Typically an application would invoke the specific container type decoder for the housed type or use a switch statement to allow a more generic series entry decoder. This example uses the same DecodeIterator when calling the content's decoder method. Optionally, an application could use a new DecodeIterator by setting the encData on a new iterator. To simplify the sample, some error handling is omitted.

//decode contents into the vector//decode each vector entry until there are no more left   
while((retVal = vectorEntry.decode(decIter)) != CodecReturnCodes.END_OF_CONTAINER) 
if(retVal <  CodecReturnCodes.SUCCESS) 
//decoding failure tends to be unrecoverable  
} 
else 
Series series = CodecFactory.createSeries(); 
retVal = series.decode(decIter); 
//Continue decoding series entries, see Series decoding example 
} 
} 
} 
else 
//decoding failure tends to be unrecoverable 
} 
}

[中]向量是索引值对条目的统一容器类型。每个条目（称为VectorEntry）都包含一个索引，与该条目在信息流中的位置和值相关。一个向量可以包含0到N个条目（零个条目表示一个空向量）。
矢量编码示例
下面的示例演示如何对包含系列值的向量进行编码。该示例对三个矢量输入值以及摘要数据进行编码：
*第一个条目是从未编码的序列中编码的
*第二个条目从包含预编码序列的缓冲区编码，并具有perm数据
*第三种是无有效载荷的清晰动作类型。
这个例子演示了初始编码方法的错误处理。为了简化示例，省略了额外的错误处理（尽管应该执行）。
*

// populate vector structure prior to call to vector.encodeInit() 
// indicate that summary data and a total count hint will be encoded 
vector.flags(VectorFlags.HAS_SUMMRAY_DATA | VectorFlags.HAS_TOTAL_COUNT | VectorFlags.HAS_PER_ENTRY_PERM_DATA); 
// populate containerType and total count hint 
vector.containerType(DataTypes.SERIES); 
vector.totalCountHint(3); 
// begin encoding of vector - assumes that encIter is already populated with 
// buffer and version information, store return value to determine success or 
// failure 
if ((retVal = vector.encodeInit(encIter, 50, 0)) < CodecReturnCodes.SUCCESS) 
{ 
// error condition - switch our success value to false so we can roll back 
success = false; 
} 
else 
{ 
// vector init encoding was successful 
// create a single VectorEntry and Series and reuse for each entry 
VectorEntry vectorEntry = CodecFactory.createVectorEntry(); 
Series series = CodecFactory.createSeries(); 
// encode expected summary data, init for this was done by 
// vector.encodeInit - this type should match vector.containerType 
{ 
// now encode nested container using its own specific encode methods 
// begin encoding of series - using same encIterator as vector 
retVal = series.encodeInit(encIter, 0, 0); 
{ 
// ----- Continue encoding series entries, see Series encoding 
// example ----- 
// Complete nested container encoding 
retVal = series.encodeComplete(encIter, success); 
} 
// complete encoding of summary data. If any series entry encoding 
// failed, success is false 
retVal = vector.encodeSummaryComplete(encIter, success); 
// FIRST Vector Entry: encode entry from unencoded data. Approx. encoded 
// length 90 bytes 
//populate index and action, no perm data on this entry 
vectorEntry.index(1); 
vectorEntry.flags(VectorEntryFlags.NONE); 
vectorEntry.action(VectorEntryActions.UPDATE); 
retVal = vectorEntry.encodeInit(encIter, 90); 
//encode contained series - this type should match vector.containerType 
{ 
//now encode nested container using its own specific encode methods 
//clear, then begin encoding of series - using same encIterator as vector 
series.clear(); 
retVal = series.encodeInit(encIter, 0, 0); 
//-----Continue encoding series entries. See example in Series --- 
retVal = series.encodeComplete(encIter, success);     
} 
//SECOND Vector Entry: encode entry from pre-encoded buffer containing an encoded Series 
//assuming pEncSeries Buffer contains the pre-encoded payload with data and length populated 
//and pPermData contains permission data information 
vectorEntry.index(2); 
//by passing permData on an entry, the map encoding functionality will implicitly set the 
//Vector.HAS_PER_ENTRY_PERM flag 
vectorEntry.flags(VectorEntryFlags.HAS_PERM_DATA); 
vectorEntry.action(VectorEntryActions.SET); 
vectorEntry.permData(permData); 
vectorEntry.encodedData(encSeries); 
retVal = vectorEntry.encode(encIter); 
//THIRD Vector Entry: encode entry with clear action, no payload on clear 
//Should clear entry for safety, this will set flags to NONE  
vectorEntry.clear(); 
vectorEntry.index(3); 
vectorEntry.action(VectorEntryFlags.CLEAR); 
retVal = vectorEntry.encode(encIter); 
} 
//complete vector encoding.  If success parameter is true, this will finalize encoding. 
//If success parameter is false, this will roll back encoding prior to vector.encodeInit(); 
retVal = vector.encodeComplete(encIter, success);

矢量解码示例
下面的示例演示了如何对向量进行解码，并将每个条目解码为包含的值。此示例代码假定封装的容器类型是一个系列。通常，应用程序会为封装的类型调用特定的容器类型解码器，或者使用switch语句来允许更通用的序列条目解码器。本例在调用内容的解码器方法时使用相同的DecodeIterator。或者，应用程序可以通过在新迭代器上设置encData来使用新的DecodeIterator。为了简化示例，省略了一些错误处理。
*

//decode contents into the vector//decode each vector entry until there are no more left   
while((retVal = vectorEntry.decode(decIter)) != CodecReturnCodes.END_OF_CONTAINER) 
if(retVal <  CodecReturnCodes.SUCCESS) 
//decoding failure tends to be unrecoverable  
} 
else 
Series series = CodecFactory.createSeries(); 
retVal = series.decode(decIter); 
//Continue decoding series entries, see Series decoding example 
} 
} 
} 
else 
//decoding failure tends to be unrecoverable 
} 
}

com.thomsonreuters.upa.codec.Vector类的使用及代码示例

Vector介绍

代码示例

相关文章

热门标签

最新文章

Vector类方法