[AAF-21] Updated Copyright Headers for AAF
[aaf/authz.git] / authz-cass / src / main / java / com / att / dao / aaf / cass / UserRoleDAO.java
1 /*******************************************************************************\r
2  * ============LICENSE_START====================================================\r
3  * * org.onap.aaf\r
4  * * ===========================================================================\r
5  * * Copyright © 2017 AT&T Intellectual Property. All rights reserved.\r
6  * * ===========================================================================\r
7  * * Licensed under the Apache License, Version 2.0 (the "License");\r
8  * * you may not use this file except in compliance with the License.\r
9  * * You may obtain a copy of the License at\r
10  * * \r
11  *  *      http://www.apache.org/licenses/LICENSE-2.0\r
12  * * \r
13  *  * Unless required by applicable law or agreed to in writing, software\r
14  * * distributed under the License is distributed on an "AS IS" BASIS,\r
15  * * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
16  * * See the License for the specific language governing permissions and\r
17  * * limitations under the License.\r
18  * * ============LICENSE_END====================================================\r
19  * *\r
20  * * ECOMP is a trademark and service mark of AT&T Intellectual Property.\r
21  * *\r
22  ******************************************************************************/\r
23 package com.att.dao.aaf.cass;\r
24 \r
25 import java.io.ByteArrayOutputStream;\r
26 import java.io.DataInputStream;\r
27 import java.io.DataOutputStream;\r
28 import java.io.IOException;\r
29 import java.nio.ByteBuffer;\r
30 import java.util.Date;\r
31 import java.util.List;\r
32 \r
33 import com.att.authz.env.AuthzTrans;\r
34 import com.att.authz.layer.Result;\r
35 import com.att.dao.Bytification;\r
36 import com.att.dao.Cached;\r
37 import com.att.dao.CassDAOImpl;\r
38 import com.att.dao.DAOException;\r
39 import com.att.dao.Loader;\r
40 import com.att.dao.Streamer;\r
41 import com.att.dao.aaf.hl.Question;\r
42 import com.att.inno.env.APIException;\r
43 import com.att.inno.env.Slot;\r
44 import com.att.inno.env.util.Chrono;\r
45 import com.datastax.driver.core.Cluster;\r
46 import com.datastax.driver.core.Row;\r
47 \r
48 public class UserRoleDAO extends CassDAOImpl<AuthzTrans,UserRoleDAO.Data> {\r
49         public static final String TABLE = "user_role";\r
50         \r
51     public static final int CACHE_SEG = 0x40; // yields segment 0x0-0x3F\r
52 \r
53         private static final String TRANS_UR_SLOT = "_TRANS_UR_SLOT_";\r
54         public Slot transURSlot;\r
55         \r
56         private final HistoryDAO historyDAO;\r
57         private final CacheInfoDAO infoDAO;\r
58         \r
59         private PSInfo psByUser, psByRole, psUserInRole;\r
60 \r
61 \r
62 \r
63         public UserRoleDAO(AuthzTrans trans, Cluster cluster, String keyspace) throws APIException, IOException {\r
64                 super(trans, UserRoleDAO.class.getSimpleName(),cluster,keyspace,Data.class,TABLE, readConsistency(trans,TABLE), writeConsistency(trans,TABLE));\r
65                 transURSlot = trans.slot(TRANS_UR_SLOT);\r
66                 init(trans);\r
67 \r
68                 // Set up sub-DAOs\r
69                 historyDAO = new HistoryDAO(trans, this);\r
70                 infoDAO = new CacheInfoDAO(trans,this);\r
71         }\r
72 \r
73         public UserRoleDAO(AuthzTrans trans, HistoryDAO hDAO, CacheInfoDAO ciDAO) {\r
74                 super(trans, UserRoleDAO.class.getSimpleName(),hDAO,Data.class,TABLE, readConsistency(trans,TABLE), writeConsistency(trans,TABLE));\r
75                 transURSlot = trans.slot(TRANS_UR_SLOT);\r
76                 historyDAO = hDAO;\r
77                 infoDAO = ciDAO;\r
78                 init(trans);\r
79         }\r
80 \r
81         private static final int KEYLIMIT = 2;\r
82         public static class Data extends CacheableData implements Bytification {\r
83                 public String  user;\r
84                 public String  role;\r
85                 public String  ns; \r
86                 public String  rname; \r
87                 public Date   expires;\r
88                 \r
89                 @Override\r
90                 public int[] invalidate(Cached<?,?> cache) {\r
91                         // Note: I'm not worried about Name collisions, because the formats are different:\r
92                         // myName ... etc versus\r
93                         // com. ...\r
94                         // The "dot" makes the difference.\r
95                         return new int[] {\r
96                                 seg(cache,user,role),\r
97                                 seg(cache,user),\r
98                                 seg(cache,role)\r
99                         };\r
100                 }\r
101 \r
102                 @Override\r
103                 public ByteBuffer bytify() throws IOException {\r
104                         ByteArrayOutputStream baos = new ByteArrayOutputStream();\r
105                         URLoader.deflt.marshal(this,new DataOutputStream(baos));\r
106                         return ByteBuffer.wrap(baos.toByteArray());\r
107                 }\r
108                 \r
109                 @Override\r
110                 public void reconstitute(ByteBuffer bb) throws IOException {\r
111                         URLoader.deflt.unmarshal(this, toDIS(bb));\r
112                 }\r
113 \r
114                 public void role(String ns, String rname) {\r
115                         this.ns = ns;\r
116                         this.rname = rname;\r
117                         this.role = ns + '.' + rname;\r
118                 }\r
119                 \r
120                 public void role(RoleDAO.Data rdd) {\r
121                         ns = rdd.ns;\r
122                         rname = rdd.name;\r
123                         role = rdd.fullName();\r
124                 }\r
125 \r
126                 \r
127                 public boolean role(AuthzTrans trans, Question ques, String role) {\r
128                         this.role = role;\r
129                         Result<NsSplit> rnss = ques.deriveNsSplit(trans, role);\r
130                         if(rnss.isOKhasData()) {\r
131                                 ns = rnss.value.ns;\r
132                                 rname = rnss.value.name;\r
133                                 return true;\r
134                         } else {\r
135                                 return false;\r
136                         }\r
137                 }\r
138 \r
139                 @Override\r
140                 public String toString() {\r
141                         return user + '|' + ns + '|' +  rname + '|' + Chrono.dateStamp(expires);\r
142                 }\r
143 \r
144 \r
145         }\r
146         \r
147         private static class URLoader extends Loader<Data> implements Streamer<Data> {\r
148                 public static final int MAGIC=738469903;\r
149         public static final int VERSION=1;\r
150         public static final int BUFF_SIZE=48;\r
151         \r
152         public static final URLoader deflt = new URLoader(KEYLIMIT);\r
153 \r
154                 public URLoader(int keylimit) {\r
155                         super(keylimit);\r
156                 }\r
157 \r
158                 @Override\r
159                 public Data load(Data data, Row row) {\r
160                         data.user = row.getString(0);\r
161                         data.role = row.getString(1);\r
162                         data.ns = row.getString(2);\r
163                         data.rname = row.getString(3);\r
164                         data.expires = row.getDate(4);\r
165                         return data;\r
166                 }\r
167 \r
168                 @Override\r
169                 protected void key(Data data, int _idx, Object[] obj) {\r
170                         int idx = _idx;\r
171                         obj[idx]=data.user;\r
172                         obj[++idx]=data.role;\r
173                 }\r
174 \r
175                 @Override\r
176                 protected void body(Data data, int _idx, Object[] obj) {\r
177                         int idx = _idx;\r
178                         obj[idx]=data.ns;\r
179                         obj[++idx]=data.rname;\r
180                         obj[++idx]=data.expires;\r
181                 }\r
182                 \r
183                 @Override\r
184                 public void marshal(Data data, DataOutputStream os) throws IOException {\r
185                         writeHeader(os,MAGIC,VERSION);\r
186 \r
187                         writeString(os, data.user);\r
188                         writeString(os, data.role);\r
189                         writeString(os, data.ns);\r
190                         writeString(os, data.rname);\r
191                         os.writeLong(data.expires==null?-1:data.expires.getTime());\r
192                 }\r
193 \r
194                 @Override\r
195                 public void unmarshal(Data data, DataInputStream is) throws IOException {\r
196                         /*int version = */readHeader(is,MAGIC,VERSION);\r
197                         // If Version Changes between Production runs, you'll need to do a switch Statement, and adequately read in fields\r
198                         \r
199                         byte[] buff = new byte[BUFF_SIZE];\r
200                         data.user = readString(is,buff);\r
201                         data.role = readString(is,buff);\r
202                         data.ns = readString(is,buff);\r
203                         data.rname = readString(is,buff);\r
204                         long l = is.readLong();\r
205                         data.expires = l<0?null:new Date(l);\r
206                 }\r
207 \r
208         };\r
209         \r
210         private void init(AuthzTrans trans) {\r
211                 String[] helper = setCRUD(trans, TABLE, Data.class, URLoader.deflt);\r
212                 \r
213                 psByUser = new PSInfo(trans, SELECT_SP + helper[FIELD_COMMAS] + " FROM user_role WHERE user = ?", \r
214                         new URLoader(1) {\r
215                                 @Override\r
216                                 protected void key(Data data, int idx, Object[] obj) {\r
217                                         obj[idx]=data.user;\r
218                                 }\r
219                         },readConsistency);\r
220                 \r
221                 // Note: We understand this call may have poor performance, so only should be used in Management (Delete) func\r
222                 psByRole = new PSInfo(trans, SELECT_SP + helper[FIELD_COMMAS] + " FROM user_role WHERE role = ? ALLOW FILTERING", \r
223                                 new URLoader(1) {\r
224                                         @Override\r
225                                         protected void key(Data data, int idx, Object[] obj) {\r
226                                                 obj[idx]=data.role;\r
227                                         }\r
228                                 },readConsistency);\r
229                 \r
230                 psUserInRole = new PSInfo(trans,SELECT_SP + helper[FIELD_COMMAS] + " FROM user_role WHERE user = ? AND role = ?",\r
231                                 URLoader.deflt,readConsistency);\r
232         }\r
233 \r
234         public Result<List<Data>> readByUser(AuthzTrans trans, String user) {\r
235                 return psByUser.read(trans, R_TEXT + " by User " + user, new Object[]{user});\r
236         }\r
237 \r
238         /**\r
239          * Note: Use Sparingly. Cassandra's forced key structure means this will perform fairly poorly\r
240          * @param trans\r
241          * @param role\r
242          * @return\r
243          * @throws DAOException\r
244          */\r
245         public Result<List<Data>> readByRole(AuthzTrans trans, String role) {\r
246                 return psByRole.read(trans, R_TEXT + " by Role " + role, new Object[]{role});\r
247         }\r
248         \r
249         /**\r
250          * Direct Lookup of User Role\r
251          * Don't forget to check for Expiration\r
252          */\r
253         public Result<List<Data>> readByUserRole(AuthzTrans trans, String user, String role) {\r
254                 return psUserInRole.read(trans, R_TEXT + " by User " + user + " and Role " + role, new Object[]{user,role});\r
255         }\r
256 \r
257 \r
258         /**\r
259      * Log Modification statements to History\r
260      * @param modified           which CRUD action was done\r
261      * @param data               entity data that needs a log entry\r
262      * @param overrideMessage    if this is specified, we use it rather than crafting a history message based on data\r
263      */\r
264         @Override\r
265         protected void wasModified(AuthzTrans trans, CRUD modified, Data data, String ... override) {\r
266         boolean memo = override.length>0 && override[0]!=null;\r
267         boolean subject = override.length>1 && override[1]!=null;\r
268 \r
269                 HistoryDAO.Data hd = HistoryDAO.newInitedData();\r
270                 HistoryDAO.Data hdRole = HistoryDAO.newInitedData();\r
271                 \r
272         hd.user = hdRole.user = trans.user();\r
273                 hd.action = modified.name();\r
274                 // Modifying User/Role is an Update to Role, not a Create.  JG, 07-14-2015\r
275                 hdRole.action = CRUD.update.name();\r
276                 hd.target = TABLE;\r
277                 hdRole.target = RoleDAO.TABLE;\r
278                 hd.subject = subject?override[1] : (data.user + '|'+data.role);\r
279                 hdRole.subject = data.role;\r
280                 switch(modified) {\r
281                         case create: \r
282                                 hd.memo = hdRole.memo = memo\r
283                                         ? String.format("%s by %s", override[0], hd.user)\r
284                                         : String.format("%s added to %s",data.user,data.role);  \r
285                                 break;\r
286                         case update: \r
287                                 hd.memo = hdRole.memo = memo\r
288                                         ? String.format("%s by %s", override[0], hd.user)\r
289                                         : String.format("%s - %s was updated",data.user,data.role);\r
290                                 break;\r
291                         case delete: \r
292                                 hd.memo = hdRole.memo = memo\r
293                                         ? String.format("%s by %s", override[0], hd.user)\r
294                                         : String.format("%s removed from %s",data.user,data.role);\r
295                                 try {\r
296                                         hd.reconstruct = hdRole.reconstruct = data.bytify();\r
297                                 } catch (IOException e) {\r
298                                         trans.warn().log(e,"Deleted UserRole could not be serialized");\r
299                                 }\r
300                                 break;\r
301                         default:\r
302                                 hd.memo = hdRole.memo = memo\r
303                                 ? String.format("%s by %s", override[0], hd.user)\r
304                                 : "n/a";\r
305                 }\r
306 \r
307                 if(historyDAO.create(trans, hd).status!=Status.OK) {\r
308                 trans.error().log("Cannot log to History");\r
309                 }\r
310                 \r
311                 if(historyDAO.create(trans, hdRole).status!=Status.OK) {\r
312                 trans.error().log("Cannot log to History");\r
313                 }\r
314                 // uses User as Segment\r
315         if(infoDAO.touch(trans, TABLE,data.invalidate(cache)).notOK()) {\r
316                 trans.error().log("Cannot touch CacheInfo");\r
317         }\r
318         }\r
319 }\r