/Users/rburkes/Projects/mobile/branches/release-1-2/devices/iphone/core/src/EMLib/EMFacetValue.h

/*
Copyright 2001, 2012, Oracle and/or its affiliates. All rights reserved.
Oracle and Java are registered trademarks of Oracle and/or its 
affiliates. Other names may be trademarks of their respective owners.
UNIX is a registered trademark of The Open Group.

This software and related documentation are provided under a license 
agreement containing restrictions on use and disclosure and are 
protected by intellectual property laws. Except as expressly permitted 
in your license agreement or allowed by law, you may not use, copy, 
reproduce, translate, broadcast, modify, license, transmit, distribute, 
exhibit, perform, publish, or display any part, in any form, or by any 
means. Reverse engineering, disassembly, or decompilation of this 
software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice 
and is not warranted to be error-free. If you find any errors, please 
report them to us in writing.
U.S. GOVERNMENT END USERS: Oracle programs, including any operating 
system, integrated software, any programs installed on the hardware, 
and/or documentation, delivered to U.S. Government end users are 
"commercial computer software" pursuant to the applicable Federal 
Acquisition Regulation and agency-specific supplemental regulations. 
As such, use, duplication, disclosure, modification, and adaptation 
of the programs, including any operating system, integrated software, 
any programs installed on the hardware, and/or documentation, shall be 
subject to license terms and license restrictions applicable to the 
programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety 
of information management applications. It is not developed or 
intended for use in any inherently dangerous applications, including 
applications that may create a risk of personal injury. If you use 
this software or hardware in dangerous applications, then you shall 
be responsible to take all appropriate fail-safe, backup, redundancy, 
and other measures to ensure its safe use. Oracle Corporation and its 
affiliates disclaim any liability for any damages caused by use of this 
software or hardware in dangerous applications.
This software or hardware and documentation may provide access to or 
information on content, products, and services from third parties. 
Oracle Corporation and its affiliates are not responsible for and 
expressly disclaim all warranties of any kind with respect to 
third-party content, products, and services. Oracle Corporation and 
its affiliates will not be responsible for any loss, costs, or damages 
incurred due to your access to or use of third-party content, products, 
or services.
*/


#import <Foundation/Foundation.h>

typedef enum {
        EMFacetValueOrderCountDesc,
        EMFacetValueOrderAlphaAsc
} EMFacetValueOrder;

#pragma mark -


@interface EMFacetValue : NSObject<NSCopying, NSCoding> {
        NSString *_value;
        NSString *_facetValueId;
        NSInteger _count;
        NSString *_separator;
        BOOL _selected;
}
@property (nonatomic, retain) NSString *value;
@property (nonatomic, retain) NSString *facetValueId;
@property (nonatomic, assign) NSInteger count;

@property (nonatomic, retain) NSString *separator;

@property (nonatomic, assign) BOOL selected;

+ (id) facetValueWithValue:(NSString *)value count:(NSInteger)count;
- (id) initWithFacetValue:(NSString *)value count:(NSInteger)count;

@end

#pragma mark -


@interface EMFacetValueSelection : NSObject<NSCopying, NSCoding>
{
        NSString *_facetValue;
        NSString *_facetValueId;
        
        EMFacetValue *_root;
        NSMutableArray *_ancestors;
        
        BOOL _removable;
        NSString *_separator;
}

@property (nonatomic, retain) NSString *facetName, *facetValue, *facetValueId;

@property (nonatomic, retain) EMFacetValue *root;

@property (nonatomic, assign) BOOL removable;

@property (nonatomic, retain) NSString *separator;

@property (nonatomic, retain) NSMutableArray *ancestors;

+ (id) facetValueSelectionWithName:(NSString *)name value:(NSString *)value;
+ (id) facetValueSelectionWithName:(NSString *)name value:(NSString *)value removable:(BOOL)removable;
- (id) initWithName:(NSString *)name value:(NSString *)value;
- (id) initWithName:(NSString *)name value:(NSString *)value removable:(BOOL)removable;
- (id) initWithName:(NSString *)name value:(NSString *)value removable:(BOOL)removable ancestors:(NSMutableArray *)ancestors;
@end

#pragma mark -

@interface EMFacetConfiguration : NSObject<NSCopying, NSCoding>
{
        NSString *_facetName;
        NSString *_facetId;
        EMFacetValueOrder _facetValueOrder;
        NSInteger _facetValueLimit;
        NSInteger _facetValueOffset;
}

+ (id) facetConfigurationWithName:(NSString *)facetName;
+ (id) facetConfigurationWithName:(NSString *)facetName limit:(NSInteger)limit;
+ (id) facetConfigurationWithName:(NSString *)facetName facetId:(NSString *)facetId;
+ (id) facetConfigurationWithName:(NSString *)facetName facetId:(NSString *)facetId limit:(NSInteger)limit;
+ (id) facetConfigurationWithName:(NSString *)facetName facetId:(NSString *)facetId order:(EMFacetValueOrder)order limit:(NSInteger)limit;

- (id) initWithFacetName:(NSString *)facetName;
- (id) initWithFacetName:(NSString *)facetName limit:(NSInteger)limit;
- (id) initWithFacetName:(NSString *)facetName facetId:(NSString *)facetId;
- (id) initWithFacetName:(NSString *)facetName facetId:(NSString *)facetId order:(EMFacetValueOrder)order limit:(NSInteger)limit;
- (id) initWithFacetName:(NSString *)facetName facetId:(NSString *)facetId order:(EMFacetValueOrder)order limit:(NSInteger)limit offset:(NSInteger)offset;

@property (nonatomic, retain) NSString *facetName;

@property (nonatomic, retain) NSString *facetId;

@property (nonatomic, assign) EMFacetValueOrder facetValueOrder;

@property (nonatomic, assign) NSInteger facetValueLimit;

@property (nonatomic, assign) NSInteger facetValueOffset;

@end

#pragma mark -

typedef enum {
        EMFacetResultMultiSelectNone = 0,
        EMFacetResultMultiSelectOr = 1,
        EMFacetResultMultiSelectAnd = 2
} EMFacetResultMultiSelect;

#pragma mark -


@interface EMFacetResult : NSObject<NSCopying, NSCoding>
{
        NSString *_facetName;
        NSString *_facetId;
        NSMutableArray *_facetValues;
        NSInteger _totalFacetValues;
        NSMutableArray *_ancestors;
        BOOL _collapsed;
        EMFacetResultMultiSelect _multiSelect;
        NSInteger _numberOfSelectedFacetValues;
}

@property (nonatomic, retain) NSString *facetName;

@property (nonatomic, retain) NSString *facetId;

@property (nonatomic, retain) NSMutableArray *facetValues;

@property (nonatomic, assign) NSInteger totalFacetValues;

@property (nonatomic, retain) NSMutableArray *ancestors;

@property (nonatomic, assign) BOOL collapsed;

@property (nonatomic, assign) EMFacetResultMultiSelect multiSelect;

@property (nonatomic, assign) NSInteger numberOfSelectedFacetValues;

- (id) initWithName:(NSString *)name;
- (id) initWithName:(NSString *)name values:(NSMutableArray *)values;
- (id) initWithName:(NSString *)name values:(NSMutableArray *)values total:(NSInteger)total;
- (id) initWithName:(NSString *)name values:(NSMutableArray *)values total:(NSInteger)total ancestors:(NSMutableArray *)ancestors;

@end