com.contentstack.sdk

Class Entry

java.lang.Object

com.contentstack.sdk.Entry

public class Entry
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
protected ContentType	contentType
protected String	contentTypeUid
protected org.json.JSONArray	exceptFieldArray
protected org.json.JSONObject	exceptJsonObject
protected LinkedHashMap<String,Object>	headers
protected String	language
protected org.json.JSONArray	objectUidForOnly
protected org.json.JSONObject	onlyJsonObject
protected HashMap<String,Object>	owner
protected org.json.JSONObject	params
protected org.json.JSONObject	publishDetails
protected org.json.JSONArray	referenceArray
protected org.json.JSONObject	resultJson
protected String	rteContent
protected String[]	tags
protected String	title
protected String	uid
protected String	url

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Entry()
protected	Entry(String contentTypeName)

Method Summary

Modifier and Type	Method and Description
Entry	addParam(String key, String value) This method adds key and value to an Entry.
Entry	configure(org.json.JSONObject jsonObject)
Entry	except(String[] fieldUid) Specifies list of field uids that would be 'excluded' from the response.
Entry	exceptWithReferenceUid(ArrayList<String> fieldUid, String referenceFieldUid) Specifies an array of 'except' keys that would be 'excluded' in the response.
void	fetch(EntryResultCallBack callback) Fetches the latest version of the entries from Contentstack.com content stack
Object	get(String key) Get object value for key.
ArrayList<Entry>	getAllEntries(String refKey, String refContentType) Get value for the given reference key.
Asset	getAsset(String key) Get an asset from the entry
List<Asset>	getAssets(String key) Get an assets from the entry.
Boolean	getBoolean(String key) Get boolean value for key.
String	getContentType() Get contentType name.
Calendar	getCreateAt() Get Calendar value of creation time of entry.
String	getCreatedBy() Get uid who created this entry.
Calendar	getDate(String key) Get Calendar value for key
Calendar	getDeleteAt() Get Calendar value of deletion time of entry.
String	getDeletedBy() Get uid who deleted this entry.
double	getDouble(String key) Get double value for key
float	getFloat(String key) Get integer value for key
Group	getGroup(String key)
List<Group>	getGroups(String key) Get a list of group from entry.
int	getInt(String key) Get integer value for key
org.json.JSONArray	getJSONArray(String key) Get JSONArray value for key
org.json.JSONObject	getJSONObject(String key) Get JSONObject value for key
String	getLocale()
long	getLong(String key) Get long value for key
Number	getNumber(String key) Get JSONObject value for key
Map<String,Object>	getOwner() Deprecated.
short	getShort(String key) Get short value for key
String	getString(String key) Get string value for key.
String[]	getTags() Get tags.
String	getTitle() Get title string
String	getUid() Get uid.
Calendar	getUpdateAt() Get Calendar value of updating time of entry.
String	getUpdatedBy() Get uid who updated this entry.
String	getURL() Get url string
Entry	includeBranch() Includes Branch in the entry response
Entry	includeContentType() Include Content Type of all returned objects along with objects themselves.
Entry	includeEmbeddedItems() includeEmbeddedItems instance of Entry Include Embedded Objects (Entries and Assets) along with entry/entries details.
Entry	includeFallback() Retrieve the published content of the fallback locale if an entry is not localized in specified locale
Entry	includeReference(String referenceField) Add a constraint that requires a particular reference key details.
Entry	includeReference(String[] referenceFields) Add a constraint that requires a particular reference key details.
Entry	includeReferenceContentTypeUID() This method also includes the content type UIDs of the referenced entries returned in the response
Entry	only(String[] fieldUid) Specifies an array of 'only' keys in BASE object that would be 'included' in the response.
Entry	onlyWithReferenceUid(ArrayList<String> fieldUid, String referenceFieldUid) Specifies an array of 'only' keys that would be 'included' in the response.
void	removeHeader(String key) Remove header key.
protected void	setContentType(ContentType contentType, LinkedHashMap<String,Object> header)
void	setHeader(String key, String value) Set headers.
Entry	setLocale(String locale)
protected void	setTags(String[] tags)
protected void	setUid(String uid)
org.json.JSONObject	toJSON() Get entry representation in json

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

params

protected org.json.JSONObject params

headers

protected LinkedHashMap<String,Object> headers

owner

protected HashMap<String,Object> owner

uid

protected String uid

publishDetails

protected org.json.JSONObject publishDetails

resultJson

protected org.json.JSONObject resultJson

title

protected String title

url

protected String url

language

protected String language

contentTypeUid

protected String contentTypeUid

contentType

protected ContentType contentType

tags

protected String[] tags

referenceArray

protected org.json.JSONArray referenceArray

objectUidForOnly

protected org.json.JSONArray objectUidForOnly

exceptFieldArray

protected org.json.JSONArray exceptFieldArray

onlyJsonObject

protected org.json.JSONObject onlyJsonObject

exceptJsonObject

protected org.json.JSONObject exceptJsonObject

rteContent

protected String rteContent

Constructor Detail

Entry

protected Entry()
         throws IllegalAccessException

Throws:

IllegalAccessException

Entry

protected Entry(String contentTypeName)

Method Detail

setContentType

protected void setContentType(@NotNull
                              ContentType contentType,
                              @NotNull
                              LinkedHashMap<String,Object> header)

configure

public Entry configure(org.json.JSONObject jsonObject)

setHeader

public void setHeader(String key,
                      String value)

Set headers.

Parameters:

key - custom_header_key

value - custom_header_value

Example :

              Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
              Entry entry = stack.contentType("form_name").entry("entry_uid");
              entry.setHeader("custom_header_key", "custom_header_value");
              

removeHeader

public void removeHeader(String key)

Remove header key.

Parameters:

key - custom_header_key

Example :

            Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
            Entry entry = stack.contentType("form_name").entry("entry_uid");
            entry.removeHeader("custom_header_key");
            

getTitle

public String getTitle()

Get title string

Returns:

String @title

Example :

         String title = entry.getTitle();
         

getURL

public String getURL()

Get url string

Returns:

String @url

Example :

         String url = entry.getURL();
         

getTags

public String[] getTags()

Get tags.

Returns:

String @tags

Example :

         String[] tags = entry.getURL();
         

setTags

protected void setTags(String[] tags)

getContentType

public String getContentType()

Get contentType name.

Returns:

String @contentTypeName

Example :

         String contentType = entry.getFileType();
         

getUid

public String getUid()

Get uid.

Returns:

String @uid

Example :

         String uid = entry.getUid();
         

setUid

protected void setUid(String uid)

getLocale

public String getLocale()

setLocale

public Entry setLocale(@NotNull
                       String locale)

Parameters:

locale - String

Returns:

Entry

Example :

         Entry entry = entry.setLanguage();
         

getOwner

@Deprecated
public Map<String,Object> getOwner()

Deprecated.

toJSON

public org.json.JSONObject toJSON()

Get entry representation in json

Returns:

JSONObject @resultJson

Example :

         JSONObject json = entry.toJSON();
         

get

public Object get(@NotNull
                  String key)

Get object value for key.

Parameters:

key - field_uid as key.

Example :

            Object obj = entry.get("key");
            

Returns:

Object @resultJson

getString

public String getString(@NotNull
                        String key)

Get string value for key.

Parameters:

key - field_uid as key.

Example :

            String value = entry.getString("key");
            

Returns:

String @getString

getBoolean

public Boolean getBoolean(@NotNull
                          String key)

Get boolean value for key.

Parameters:

key - field_uid as key.

Example :

            Boolean value = entry.getBoolean("key");
            

Returns:

boolean @getBoolean

getJSONArray

public org.json.JSONArray getJSONArray(@NotNull
                                       String key)

Get JSONArray value for key

Parameters:

key - field_uid as key.

Example :

            JSONArray value = entry.getJSONArray("key");
            

Returns:

JSONArray @getJSONArray

getJSONObject

public org.json.JSONObject getJSONObject(@NotNull
                                         String key)

Get JSONObject value for key

Parameters:

key - field_uid as key.

Example :

            JSONObject value = entry.getJSONObject("key");
            

Returns:

JSONObject @getJSONObject

getNumber

public Number getNumber(@NotNull
                        String key)

Get JSONObject value for key

Parameters:

key - field_uid as key.

Example :

            JSONObject value = entry.getJSONObject("key");
            

Returns:

Number @getNumber

getInt

public int getInt(@NotNull
                  String key)

Get integer value for key

Parameters:

key - field_uid as key.

Example :

            int value = entry.getInt("key");
            

Returns:

int @getInt

getFloat

public float getFloat(@NotNull
                      String key)

Get integer value for key

Parameters:

key - field_uid as key.

Returns:

float @getFloat

Example :

         float value = entry.getFloat("key");
         

getDouble

public double getDouble(@NotNull
                        String key)

Get double value for key

Parameters:

key - field_uid as key.

Returns:

double @getDouble

Example :

         double value = entry.getDouble("key");
         

getLong

public long getLong(@NotNull
                    String key)

Get long value for key

Parameters:

key - field_uid as key.

Example :

            long value = entry.getLong("key");
            

Returns:

long @getLong

getShort

public short getShort(@NotNull
                      String key)

Get short value for key

Parameters:

key - field_uid as key.

Example :

            short value = entry.getShort("key");
            

Returns:

short @getShort

getDate

public Calendar getDate(@NotNull
                        String key)

Get Calendar value for key

Parameters:

key - field_uid as key.

Example :

            Calendar value = entry.getDate("key");
            

Returns:

Calendar @getDate

getCreateAt

public Calendar getCreateAt()

Get Calendar value of creation time of entry.

Returns:

Calendar @getCreateAt

Example :

         Calendar createdAt = entry.getCreateAt("key");
         

getCreatedBy

public String getCreatedBy()

Get uid who created this entry.

Returns:

String @getCreatedBy

Example :

         String createdBy_uid = entry.getCreatedBy();
         

getUpdateAt

public Calendar getUpdateAt()

Get Calendar value of updating time of entry.

Returns:

Calendar @getUpdateAt

Example :

         Calendar updatedAt = entry.getUpdateAt("key");
         

getUpdatedBy

public String getUpdatedBy()

Get uid who updated this entry.

Returns:

String @getString

Example :

         String updatedBy_uid = entry.getUpdatedBy();
         

getDeleteAt

public Calendar getDeleteAt()

Get Calendar value of deletion time of entry.

Returns:

Calendar

Example :

         Calendar updatedAt = entry.getUpdateAt("key");
         

getDeletedBy

public String getDeletedBy()

Get uid who deleted this entry.

Returns:

String

Example :

         String deletedBy_uid = entry.getDeletedBy();
         

getAsset

public Asset getAsset(String key)

Get an asset from the entry

Parameters:

key - field_uid as key.

Returns:

Asset

Example :

         Asset asset = entry.getAsset("key");
         

getAssets

public List<Asset> getAssets(String key)

Get an assets from the entry. This works with multiple true fields

Example :

 {
     @code
     List asset = entry.getAssets("key");
 }
 

Parameters:

key - This is the String key

Returns:

ArrayList This returns list of Assets.

getGroup

public Group getGroup(String key)

Parameters:

key - Get a group from entry.

key - field_uid as key.

Example :

             Group innerGroup = entry.getGroup("key");
             return null
            

Returns:

Group

getGroups

public List<Group> getGroups(String key)

Get a list of group from entry.

Note :- This will work when group is multiple true.

Parameters:

key - field_uid as key.

Returns:

list of group from entry

Example :

         Group innerGroup = entry.getGroups("key");
         

getAllEntries

public ArrayList<Entry> getAllEntries(String refKey,
                                      String refContentType)

Get value for the given reference key.

Parameters:

refKey - key of a reference field.

refContentType - class uid.

Returns:

ArrayList of Entry instances. Also specified contentType value will be set as class uid for all Entry instance.

Example :

          Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          Query csQuery = stack.contentType("contentType_name").query();
          csQuery.includeReference("for_bug");
          csQuery.find(new QueryResultsCallBack() {<br>
          &#64;Override
          public void onCompletion(ResponseType responseType, QueryResult queryResult, Error error) {<br>
              if(error == null){
                  List&#60;Entry&#62; list = builtqueryresult.getResultObjects();
                   for (int i = 0; i < list.queueSize(); i++) {
                         Entry   entry   = list.get(i);
                         Entry taskEntry = entry.getAllEntries("for_task", "task");
                  }
              }
          }
      });
      

         

except

public Entry except(@NotNull
                    String[] fieldUid)

Specifies list of field uids that would be 'excluded' from the response.

Parameters:

fieldUid - field uid which get 'excluded' from the response.

Returns:

Entry object, so you can chain this call.

Example :

          Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          Entry entry = stack.contentType("form_name").entry("entry_uid");

          entry.except(new String[]{"name", "description"});
         

includeReference

public Entry includeReference(@NotNull
                              String referenceField)

Add a constraint that requires a particular reference key details.

Parameters:

referenceField - key that to be constrained.

Returns:

Entry object, so you can chain this call.

Example :

          Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          Entry entry = stack.contentType("form_name").entry("entry_uid");

          entry.includeReference("referenceUid");
         

includeReference

public Entry includeReference(@NotNull
                              String[] referenceFields)

Add a constraint that requires a particular reference key details.

Parameters:

referenceFields - array key that to be constrained.

Returns:

Entry object, so you can chain this call.

Example :

           Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          Entry entry = stack.contentType("form_name").entry("entry_uid");

          entry.includeReference(new String[]{"referenceUid_A", "referenceUid_B"});
         

only

public Entry only(String[] fieldUid)

Specifies an array of 'only' keys in BASE object that would be 'included' in the response.

Parameters:

fieldUid - Array of the 'only' reference keys to be included in response.

Returns:

Entry object, so you can chain this call.

Example :

          Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          Entry entry = stack.contentType("form_name").entry("entry_uid");

          entry.only(new String[]{"name", "description"});
         

onlyWithReferenceUid

public Entry onlyWithReferenceUid(@NotNull
                                  ArrayList<String> fieldUid,
                                  @NotNull
                                  String referenceFieldUid)

Specifies an array of 'only' keys that would be 'included' in the response.

Parameters:

fieldUid - Array of the 'only' reference keys to be included in response.

referenceFieldUid - Key who has reference to some other class object..

Returns:

Entry object, so you can chain this call.

Example :

                Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          Entry entry = stack.contentType("form_name").entry("entry_uid");

          ArrayList<String> array = new ArrayList<String>();
          array.add("description");
          array.add("name");
          entry.onlyWithReferenceUid(array, "referenceUid");
         

exceptWithReferenceUid

public Entry exceptWithReferenceUid(@NotNull
                                    ArrayList<String> fieldUid,
                                    @NotNull
                                    String referenceFieldUid)

Specifies an array of 'except' keys that would be 'excluded' in the response.

Parameters:

fieldUid - Array of the 'except' reference keys to be excluded in response.

referenceFieldUid - Key who has reference to some other class object.

Returns:

Entry object, so you can chain this call.

Example :

          Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          Entry entry = stack.contentType("form_name").entry("entry_uid");

          ArrayList<String> array = new ArrayList<String>();
          array.add("description");
          array.add("name");

          entry.onlyWithReferenceUid(array, "referenceUid");
         

fetch

public void fetch(EntryResultCallBack callback)

Fetches the latest version of the entries from Contentstack.com content stack

Parameters:

callback - EntryResultCallBack object to notify the application when the request has completed.

Example :

                 Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
                 Entry entry = stack.contentType("form_name").entry("entry_uid");<br>
                 entry.fetch(new EntryResultCallBack() {<br>
                 &#64;Override
                 public void onCompletion(ResponseType responseType, Error error) {
                 }<br>
                 });<br>
                 
                 

addParam

public Entry addParam(@NotNull
                      String key,
                      @NotNull
                      String value)

This method adds key and value to an Entry.

Parameters:

key - The key as string which needs to be added to an Entry

value - The value as string which needs to be added to an Entry

Returns:

Entry

Example :

         Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
         final Entry entry = stack.contentType("user").entry("entryUid"); <br>
         entry.addParam("include_dimensions", "true"); <br>
         entry.fetch(new ResultCallBack() {
         <br>&#64; Override
          public void onCompletion(ResponseType responseType, Error error) {
          }<br>
          });<br>
          
         

includeReferenceContentTypeUID

public Entry includeReferenceContentTypeUID()

This method also includes the content type UIDs of the referenced entries returned in the response

Returns:

Entry
Example :

          Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          final Entry entry = stack.contentType("user").entry("entryUid"); <br>
          entry.includeReferenceContentTypeUID; <br>
          entry.fetch(new EntryResultCallBack() {
          <br>&#64;Override
          public void onCompletion(ResponseType responseType, Error error) {
          }<br>
          });<br>
          
         

includeContentType

public Entry includeContentType()

Include Content Type of all returned objects along with objects themselves.

Returns:

Entry object, so you can chain this call.

Example :

         Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
         final Entry entry = stack.contentType("user").entry("entryUid");
         entry.includeContentType();
         

includeFallback

public Entry includeFallback()

Retrieve the published content of the fallback locale if an entry is not localized in specified locale

Returns:

Entry object, so you can chain this call.

Example :

         Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
         final Entry entry = stack.contentType("user").entry("entryUid");
         entry.includeFallback();
         

includeEmbeddedItems

public Entry includeEmbeddedItems()

includeEmbeddedItems instance of Entry Include Embedded Objects (Entries and Assets) along with entry/entries details.

Returns:

Entry object, so you can chain this call.

Example :

         Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
         final Entry entry = stack.contentType("user").entry("entryUid");
         entry.includeEmbeddedItems();
         

includeBranch

public Entry includeBranch()

Includes Branch in the entry response

Returns:

Entry object, so you can chain this call.

Example :

         Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
         final Entry entry = stack.contentType("user").entry("entryUid");
         entry.includeBranch();